أبرز التحديثات
الاستجابات التي تتجاوز الحصة أصبحت الآن ترجع HTTP 429 مع ترويسة Retry-After، وهو ما يطابق ما ترسله OpenAI و GitHub و Cloudflare. تمت إضافة صف للنطاق الترددي في صفحة التسعير (كل خطة عامة غير محدودة). والطلبات التي تطلب exitCountries في خطة بدون استهداف جغرافي تحصل الآن على 403 واضح يذكر المعلمة والحل.
الجديد
حدود الحصة تتحدث الآن HTTP 429، وليس 402
إذا وصلت إلى حد الخطة (الأرصدة أو النطاق الترددي)، ستكون الاستجابة 429 Too Many Requests مع Retry-After في كل رد و resets_at في النص يشير إلى نهاية فترة الفوترة الخاصة بك. يخبرك حقل reason بالحد الذي وصلت إليه (plan_limit_credits أو plan_limit_bandwidth) حتى لا يتعارض مع حدود المعدل لكل دقيقة.
لماذا التغيير؟ 402 يبدو صحيحًا ("مطلوب الدفع") ولكن في الممارسة العملية، هذه هي الطريقة التي تبلغ بها Stripe عن الرسوم الفاشلة، والعديد من عملاء HTTP والوكلاء يتعاملون معها بشكل خاطئ. ترفض كل من OpenAI و GitHub و Twilio و Cloudflare الحصص المتجاوزة بـ 429 ورمز خطأ مميز. اتباع هذا النهج هنا هو الخطوة الصحيحة: كل مكتبة إعادة محاولة في العالم تعرف بالفعل ماذا تفعل مع استجاباتنا.
يتم تحديد قيمة Retry-After بـ 24 ساعة للأشخاص الذين يفضلون النوم وإعادة المحاولة. إذا كنت تريد وقت إعادة الضبط الحقيقي، فاقرأ resets_at من نص JSON.
النطاق الترددي على صفحة التسعير: غير محدود
تمت إضافة صف للنطاق الترددي في مصفوفة المقارنة الخاصة بـ /prices. كل خطة عامة تأتي بنطاق ترددي غير محدود، والمصفوفة الآن تصرح بذلك. إنه نوع الشيء الذي لا تحتاجه حتى يسأل أحد العملاء المحتملين ولا يمكنك العثور على الرقم. الآن هو موجود في الصفحة.
تُظهر الخطط المخصصة التي تحد من النطاق الترددي رقم الجيجابايت الخاص بها في نفس الصف.
الاستهداف الجغرافي يرفض نفسه بخطأ مناسب
إذا أرسل طلب exitCountries بينما لا تتضمن الخطة ميزة الاستهداف الجغرافي، فستكون الاستجابة 403 مع رسالة تذكر المعلمة وكيفية إصلاحها. في السابق، كان الطلب يمر كما لو كان الاستهداف الجغرافي مسموحًا به. الآن يفشل بصوت عالٍ عند الباب.
الطلبات التي لا تحتوي على exitCountries لا تتأثر. هذا لا يبدأ إلا عندما تطلب الميزة فعليًا.
إصلاحات صغيرة في لوحة التحكم بشأن الحدود والفوترة
ثلاثة إصلاحات لتحسين جودة الحياة:
- علامة تبويب الحدود. يتم استعادة علامة التبويب الفرعية المحفوظة (نظرة عامة / مفاتيح API / الحدود والميزات) قبل الرسم، لذلك لم تعد ترى وميض علامة تبويب خاطئة عند إعادة التحميل.
- مفاتيح API. يستخدم مربع البحث نمط البحث القياسي بدلاً من الإدخال العاري.
- الفوترة. يتم الآن عرض خطوط التعريف أسفل طريقة الدفع بالتصميم الصحيح (كانت تسقط غير مصممة من قبل).
تحت الغطاء
أوضاع إنفاذ حدود الخطة قابلة للتبديل المباشر الآن. يمكن تبديل كل من حدود مستوى البيانات الستة (التزامن لكل منتج، والمعدل لكل دقيقة، والمتصفح لكل يوم، والأرصدة، والنطاق الترددي، والميزات) بالإضافة إلى فحص إنشاء المفتاح على مستوى الإدارة بين إيقاف التشغيل، والإشارة، والإنفاذ من لوحة إعدادات يتحكم فيها فريقنا. بدون إعادة نشر. يقوم مُحدِّث في الخلفية باستطلاع الإعداد كل 60 ثانية ويبقى المسار الساخن متزامنًا.
لماذا يهمك هذا الأمر؟ عندما يواجه أي حد مشكلة في بيئة الإنتاج، يمكننا التراجع عنه في غضون دقيقة بدلاً من نشر كود جديد. كما يتيح لنا تطبيق الإنفاذ تدريجياً لكل حد، ومراقبة سلوك الزيارات الفعلية في كل خطوة. يسجل وضع الإشارة الحدث دون حظره، بينما يقوم الإنفاذ بتفعيل الاستجابة 429 أو 403. أردنا أن تكون الخطوة المتوسطة أساسية بدلاً من كونها مجرد مفتاح للطوارئ.
الأرقام
Retry-Afterالحد الأقصى لرفض الحصص: 24 ساعة (وقت إعادة الضبط الفعلي فيresets_at)- فترة استعلام إعدادات وقت التشغيل: 60 ثانية
- الخطط العامة بنطاق ترددي غير محدود: جميعها
كان مقيد الخطط هو المحور الأساسي لمدة شهر. الخطوة التالية: الإنفاذ على الحدود الأولى (تبدو الأرصدة والتزامن لكل منتج كأول زوج طبيعي)، بالإضافة إلى تحذيرات البريد الإلكتروني بمجرد إطلاق مرحلة المراسلة.