الانتقال إلى المحتوى الرئيسي
GetQR API في مرحلة تجريبية (beta) ومتاحة لمساحات عمل مختارة. قد تتغير التفاصيل قبل الإصدار العام.
تحدّ GetQR API من عدد الطلبات التي يمكن لكل مفتاح API إرسالها، حتى لا يتسبب تكامل واحد في إبطاء الواجهة على الجميع.

الحدود

يُحتسب الحد على نافذة منزلقة مدتها دقيقة واحدة، ويُطبَّق على جميع نقاط النهاية معًا. لا يحتاج فحص الحالة إلى مفتاح ولا يُحتسب.

ترويسات حدود الطلبات

تحمل الاستجابات للطلبات التي تستخدم مفتاح API صالحًا هذه الترويسات، بما في ذلك استجابات الأخطاء:

عند تجاوز الحد

عند تجاوز الحد، تُرجع الواجهة 429 مع الرمز rate_limit_exceeded والترويسات نفسها:
انتظر حتى وقت إعادة التعيين قبل إرسال مزيد من الطلبات. أضف تأخيرًا عشوائيًا (jitter) حتى لا تعيد عدة عمليات المحاولة في اللحظة نفسها، واستخدم التراجع الأُسّي مع أخطاء 5xx:
لا تُعد محاولة POST /api/v1/qrs إلا مع الترويسة Idempotency-Key. عندها لن تُنشئ إعادة المحاولة رمز QR ثانيًا أبدًا. راجع عدم التكرار (Idempotency).

البقاء ضمن الحد

  • راقب X-RateLimit-Remaining وأبطئ قبل أن تصل إلى 0.
  • استخدم الإنشاء المجمّع لرموز QR بدلًا من طلب واحد لكل رمز QR.
  • اجلب حتى 100 نتيجة في الصفحة باستخدام pageSize=100. راجع ترقيم الصفحات.
  • خزّن صور QR مؤقتًا: تُرجع عمليات التنزيل ETag، فيمكنك إرسال If-None-Match والحصول على 304 Not Modified عندما لا يتغير شيء.

الخطوات التالية

الأخطاء

رموز QR