حدود المعدل

تحسب Sofia API الطلبات في ثلاث نوافذ: 15 دقيقة و24 ساعة و30 يومًا.

الرمز	15 دقيقة	24 ساعة	30 يومًا
مفتاح شخصي (لكل حساب)	150	1,000	10,000
عميل OAuth	100	500	15,000
عميل OAuth، لكل شخص مفوِّض (حتى 1,000)	+10	+25	+100

الترويسات

كل جواب يخبرك بما تبقى، بصيغة IETF:

http

RateLimit: "15m";r=144;t=43, "24h";r=994;t=13543, "30d";r=9994;t=13543
RateLimit-Policy: "15m";q=150;w=900, "24h";q=1000;w=86400, "30d";q=10000;w=2592000

r هو عدد الطلبات المتبقية، وt الثواني حتى تُعاد النافذة، وq الحصة، وw النافذة بالثواني.

عندما تمتلئ نافذة

الجواب هو 429 rate_limit_exceeded، مع الترويسة Retry-After والنافذة المستنفدة في details. انتظر هذه المدة قبل إعادة المحاولة.

استخدم الـ API بكفاءة

سجّل webhook بدل الاستعلام المتكرر عن منشور.
استخدم limit حتى 100 لقراءة القوائم في صفحات أقل.
خزّن مؤقتًا ما نادرًا ما يتغير: المنصات، والمنشآت، والحسابات المتصلة.