وثائق المطورين تُنشر بالإنجليزية. الشريط الجانبي يتبع اللغة المختارة.

الدعم والفوترة

كيف تعمل الأرصدة وحدود المعدل والأخطاء — وكيف تُرقّي اشتراكك.

الأرصدة والفوترة

  • ✅ HTTP 200 فقط: رصيد واحد لكل طلب ناجح (نقاط النهاية المدفوعة).
  • ❌ أخطاء 4xx / 5xx: لا تُحسب أبدًا — أعد المحاولة بأمان.
  • ❌ حد المعدل (429): لا يُحسب أبدًا.
  • ✅ نقاط النهاية المجانية: /v1/verify، /v1/youtube/channel/resolve، /v1/youtube/channel/latest، GET /v1/youtube/asr/{task_id} (استطلاع)، جميع قراءات /v1/library.
  • 📦 نقاط النهاية المقسّمة: رصيد لكل صفحة (فيديوهات القناة، قائمة التشغيل).

الخطط: المجانية 1000 رصيد · Pro 10,000 رصيد/شهر · راجع التسعير.

حدود المعدل

كل مفتاح API محدود بـ 200 طلبًا في الدقيقة. كل استجابة تتضمن ترويسات الحدود:

الترويسةالوصف
X-RateLimit-Limitالإجمالي المسموح به في الدقيقة (200)
X-RateLimit-Remainingالطلبات المتبقية في النافذة الحالية
X-RateLimit-Resetطابع Unix لإعادة تعيين النافذة

عند تجاوز الحد يُرجع API 429 مع ترويسة Retry-After (ثوانٍ).

رموز الأخطاء

الحالةالمعنىمحسوبة؟
200نجاحنعم (النقاط المدفوعة)
400طلب غير صالح / معامِلات مفقودةلا
401مفتاح API غير صالح أو مفقودلا
402نفاد الأرصدةلا
404فيديو / قناة / ترجمات غير موجودةلا
429تجاوز حد المعدللا
500خطأ داخلي في الخادملا

أجسام استجابات الأخطاء

401 Unauthorized

{ "error": { "code": "UNAUTHORIZED", "message": "Invalid or missing API key" } }

402 نفاد الأرصدة

{ "error": { "code": "CREDITS_EXHAUSTED", "message": "You've run out of credits. Upgrade or top up." } }

404 غير موجود (بدون ترجمات)

{ "error": { "code": "NO_CAPTIONS", "message": "No captions available for this video" } }

429 تجاوز الحد

{ "error": { "code": "RATE_LIMITED", "message": "Rate limit exceeded, retry in 12s" } }
// تتضمن الاستجابة ترويسة أيضًا:  Retry-After: 12

الدعم