الملاحظاتاحصل على وصول API
المطورون

ابنِ على API وSDKs

7:50 شرح عملي

التعليق الصوتي في الفيديو باللغة الإنجليزية.

Toktik Developer API واجهة REST مقيسة، إضافة إلى حزم SDK رسمية — @toktikhq/sdk-js لـ JavaScript/TypeScript وtoktik لـ Python. ابدأ بالبدء السريع والمصادقة والرصيد، ثم انسخ أمثلة جاهزة بـ cURL وJavaScript وPython.

ما الذي ستتعلمه

  • أنشئ مفتاحاً ونفّذ أول طلب موثَّق
  • افهم النطاقات وحدود المعدل ونموذج الرصيد
  • استخدم حزمتي SDK لـ JavaScript وPython
  • اقرأ الوثائق: البدء السريع ونقاط النهاية والنطاقات

كيف يعمل

  1. أنشئ مفتاحاً في Settings

    في التطبيق افتح Settings ثم Developer keys، وأنشئ مفتاحاً بالنطاقات التي تحتاجها فقط، مثل rank:read للترتيبات. يبدأ السر بـ ttk_live_ ويظهر مرة واحدة، فخزّنه في متغير بيئة. تصل المفاتيح إلى مسارات البيانات فقط، وتظل عملية إنشاء المفاتيح إجراءً لا يتم إلا بجلسة مسجَّل دخولها.

  2. نفّذ أول طلب

    أرسل المفتاح على هيئة Authorization: Bearer مع سرك ttk_live_. يستدعي البدء السريع في الوثائق لوحة الترتيب الرسمي عند api.toktikhq.com/v1/rankings/official مع board=hourly وregion=VN. تعني 403 أن المفتاح يفتقر إلى النطاق اللازم لذلك المسار.

  3. اعمل ضمن الحدود والرصيد

    لكل مفتاح حد طلبات في الثانية بحسب الخطة، من 1 في Free إلى 150 في Agency. عند تجاوز الحد تحصل على 429، فانتظر Retry-After ثم أعد المحاولة. أما نفاد الرصيد فيعيد 402 ولا تحله إعادة المحاولة، ويعرض GET /v1/usage إنفاقك.

  4. أضف SDK رسمية

    ثبّت npm i @toktikhq/sdk-js لـ JavaScript وTypeScript، أو pip install toktik لـ Python؛ وكلتاهما تستدعيان واجهة v1 REST نفسها بالمفتاح نفسه ومحفظة الرصيد نفسها. تسرد صفحتا Docs، Quickstart وAPI Reference، كل نقطة نهاية ومعامل ونطاق.

الأسئلة الشائعة

كم تكلّف Toktik API؟

لا توجد قائمة أسعار منفصلة لـ API. يستهلك تطبيق الويب وAPI محفظة الرصيد نفسها ضمن الخطة نفسها. القراءة المخدومة من مخزن Toktik تكلّف 1 رصيد، والتصدير يكلّف 2,500 رصيد، وتكلّف استدعاءات الجمع عند الطلب أكثر.

ما حدود معدل Toktik API؟

لكل مفتاح في الثانية: Free ‏1 وStarter ‏5 وPro ‏20 وScale ‏60 وAgency ‏150. وتنطبق أيضاً حصص يومية، من 5,000 طلب في Free إلى 1,200,000 في Agency. يؤدي تجاوز الحد إلى 429 مع ترويسات تبيّن حالة النافذة.

هل لدى Toktik حزم SDK رسمية؟

نعم. @toktikhq/sdk-js تغطي JavaScript وTypeScript، وحزمة toktik تغطي Python. وكلتاهما تستدعيان واجهة v1 REST نفسها بالمفتاح نفسه.

ما الفرق بين 402 و403 من Toktik API؟

تعني 402 أن مساحة العمل نفد رصيدها، فاشحن الرصيد بدلاً من إعادة المحاولة. وتعني 403 أن المفتاح صالح لكنه يفتقر إلى النطاق المطلوب، فامنحه إياه أو استخدم جلسة مسجَّل دخولها. أما 429 فهي حد معدل، ويمكن إعادة المحاولة بأمان بعد التمهل.

اقرأ وثائق API كل الأدلة

المزيد في هذا القسم