دليل دمج Open API لمنصة YouTube videos and Shorts

تعرّف على تحليل رابط YouTube videos and Shorts عام عبر Open API من TapSave ومعالجة موارد الوسائط التي يعيدها التطبيق.

مسار التكامل

أرسل طلب POST إلى https://api.videotool.cc/openapi/parse مع Content-Type: application/json ورأس X-API-Key وحقل url للرابط العام داخل JSON.

معالجة الاستجابة

تحقق أولاً من code === 200 وdata.resultCode === 0 وdata.hasResource === true. ثم عالج مصفوفات الموارد التي أعادتها هذه الاستجابة فقط؛ لا تنشئ عناوين URL ولا تفترض تنسيقاً ثابتاً.

YouTube videos and Shorts resources

For YouTube, audio can be in videoList[].audioUrl or audioList; do not promise audio or MP4 when those fields are empty.

القيود والأمان

احتفظ بمفتاح API على الخادم ولا تعرضه في المتصفح. يجب التعامل مع الروابط الخاصة أو المحذوفة أو المقيّدة أو غير المتاحة كأخطاء تحليل متوقعة.