01 · البدء السريع
إرسال طلب تحليل
أضف مفتاح API إلى الرأس وأرسل رابطًا عامًا واحدًا في جسم JSON.
curl -X POST https://api.videotool.cc/openapi/parse \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://..."}'02 · المصادقة
المصادقة بمفتاح API
أرسل X-API-Key مع كل طلب. يمكنك عرض المفتاح أو تغييره من وحدة التحكم.
X-API-Key
YOUR_API_KEYاحتفظ بمفتاح API على الخادم ولا تضعه في تطبيق أو مستودع عام.
03 · نقطة النهاية
نقطة النهاية المتاحة
POST
/openapi/parseرابط واحدتحليل رابط وسائط عام واحد
أرسل رابط منشور أو فيديو عام. يُخصم رصيد واحد بعد إرجاع موارد قابلة للاستخدام.
url | string · required | رابط منشور أو فيديو عام |
04 · الاستجابة
استجابة ناجحة
تعيد المكالمة الناجحة ParseResult داخل AjaxResult مع الفيديو والصور والصوت والنص.
{
"code": 200,
"msg": "操作成功",
"data": {
"resultCode": 0,
"hasResource": true,
"resourceType": 200,
"descList": ["..."],
"imgList": [],
"videoList": [],
"audioList": []
}
}05 · الأخطاء
رموز أخطاء الأعمال
| code | المعنى | الخصم |
|---|---|---|
400 | الرابط مفقود أو غير صالح | دون خصم |
401 | مفتاح API مفقود أو غير صالح أو معطل | دون خصم |
403 | الرصيد غير كافٍ | دون خصم |
422 | لم تُرجع موارد قابلة للاستخدام | دون خصم |
500 | خطأ في خدمة التحليل | دون خصم |
06 · الفوترة
الفوترة للنتائج الناجحة فقط
1رصيد مخصوم عند إرجاع موارد قابلة للاستخدام
0أرصدة مخصومة عند الفشل أو النتيجة الفارغة
النطاق الحالي
توفر Open API فقط POST /openapi/parse لرابط واحد، دون دفعات أو capabilities أو ذاكرة منع التكرار أو تحديد معدل.