آخر تحديث
وحدات الرصيد
لكل مساحة عمل محفظة رصيد تُعاد تعبئتها في كل دورة فوترة. تستهلك استدعاءات API وقراءات لوحة التحكم من المحفظة نفسها؛ ويذكر المرجع فئة كل عملية.
تكلفة كل عملية
| الفئة | وحدات الرصيد لكل استدعاء | ما تشمله |
|---|---|---|
| قراءة مخزنة مؤقتًا | 1 | كل قراءة للبيانات المحفوظة: التصنيفات، وصنّاع المحتوى، والرؤى، والفيديوهات، والتعليقات، والاتجاهات، وجلسات LIVE. وعرض مفاتيح API (GET /v1/api-keys) قراءة مخزنة مؤقتًا أيضًا. |
| قائمة المتابِعين/المتابَعين | 4,000 | GET /v1/creators/{uid}/following أو /followers عندما يلزم جمع القائمة من جديد (بدلًا من 1). |
| التعليقات | 500 | GET /v1/videos/{id}/comments عندما يلزم جمع التعليقات من جديد (بدلًا من 1). |
| تحديث الملف الشخصي | 1,250 | GET /v1/creators/{uid} عندما يُعاد جلب ملف شخصي قديم، إضافةً إلى تكلفة القراءة. لا يُحتسب إلا إذا أُرجع ملف شخصي. |
| تحديث حالة البث | 1,250 | POST /v1/live/creators/{uid}/refresh: يطلب من العمّال فحص صانع محتوى الآن. |
| التصدير | 2,500 | POST /v1/exports: إنشاء ملف CSV أو Excel. |
| إرسال webhook | 1 | كل webhook ترسله قاعدة تنبيه، بما في ذلك الذي يرسله اختبار القاعدة. |
| مجاني | 0 | إدارة قواعد التنبيه، وعرض ملفات التصدير وتنزيلها، وإنشاء المفاتيح وإلغاؤها، واستحقاقات الباقة، والاستخدام. |
تعرض كل عملية في المرجع فئتها بجانب نطاقها. وتُحتسب الإجابة 202 (عندما يكون الجمع لا يزال جاريًا) كقراءة مخزنة مؤقتًا.
الحصة الشهرية
في كل شهر ميلادي (بتوقيت UTC) تمنح باقة مساحة العمل حصتها، وذلك عند أول استدعاء محتسَب أو أول قراءة للمحفظة في ذلك الشهر. لا يمكن أن يتجاوز الإنفاق في الشهر الحصة الممنوحة. راجع الأسعار للاطلاع على الباقات.
| الباقة | وحدات الرصيد شهريًا |
|---|---|
| Free | 150,000 |
| Starter | 450,000 |
| Pro | 3,000,000 |
| Scale | 12,000,000 |
| Agency / Enterprise | 36,000,000 |
عندما تفرغ المحفظة
يُرجع الاستدعاء المحتسَب الذي سيتجاوز الحد الأقصى 402 مع الرمز credit_cap_exceeded ضمن غلاف الخطأ المعتاد. وتستمر العمليات المجانية في العمل. تُعاد تعبئة المحفظة في بداية الشهر التالي، والترقية في منتصف الشهر ترفع الحد الأقصى.
4xx أو 5xx شيئًا. أما 2xx أو 3xx فتُحتسب.قراءة المحفظة
تُرجع GET /v1/entitlements الباقة والحدود ومحفظة الفترة الحالية؛ وتعرض GET /v1/usage الإنفاق مفصّلًا حسب العملية. كلتاهما مجانية وتتطلب النطاق keys:manage.
curl "https://api.toktokdata.live/v1/entitlements" \ -H "Authorization: Bearer $ROOMSCOPE_API_KEY" # data.credits: { "period": "2026-11-01", "monthlyAllotment": …, "hardCap": …, "spent": …, "remaining": … }