استخدام واجهة API
حدود الطلبات
حدود الطلبات لكل مفتاح، والتعامل مع الخطأ 429.
لكل مفتاح «دلو رموز» (token bucket): يستطيع إرسال دفعة طلبات حتى سعته القصوى، ثم يمتلئ من جديد بمعدل ثابت. الحدود لكل مفتاح، لا لكل حساب.
| المفتاح | الدفعة القصوى | المعدل المستمر |
|---|---|---|
sk_live_ | 600 طلب | 10 في الثانية |
sk_test_ | 60 طلبًا | 1 في الثانية |
عند تجاوز الحد تعيد واجهة API الخطأ 429 rate_limited مع retry_after (بالثواني) في المحتوى. لا يُخصم شيء. انتظر تلك المدة ثم أعد المحاولة.
المنصات نفسها تفرض حدودًا على الطلبات أيضًا. نستوعب ذلك بالتخزين المؤقت وإعادة المحاولة والتحويل إلى مصادر بديلة، وإذا استمرت المنصة في الرفض تحصل على
platform_unavailable ويُردّ الرصيد.