العقبات
ليس هناك أي خطأ في هذا. هذا سلوك من الأفضل أن تتعرف عليه من الوثائق بدلاً من تحليل إجابة شخص آخر.
في الاستجابة يوجد حقل زائد _footer
Section titled “في الاستجابة يوجد حقل زائد _footer”الخطة المجانية و أي طلب بدون مفتاح يحصلان في الجسم على حقل إضافي _footer مع توقيع. المفاتيح المدفوعة لا ترى هذا الحقل. إذا كان محللّك صارمًا تجاه الحقول الزائدة، فهذا أول شيء سيصادفه.
طلب مكرر متطابق يكلف صفر
Section titled “طلب مكرر متطابق يكلف صفر”طلب متطابق خلال نافذة التخزين المؤقت يُعيد X-Cache: HIT، وهذا الطلب لا يخصم أي ائتمانات: في الاستجابة X-Credits-Used: 0، وتُعاد الرصيد المتبقي. بمعنى أنه لا يمكنك قياس التكلفة بتكرار نفس الطلب، ستدفع مرة واحدة فقط.
مفتاح Sandbox لا يستهلك شيئًا
Section titled “مفتاح Sandbox لا يستهلك شيئًا”aw_test_* لا يخصم أي ائتمانات على الإطلاق ولا يُحسب ضمن حد الحساب. هذا ليس “حصة صغيرة”، إنه صفر. يجب التطوير باستخدامه، واستخدام aw_live_* فقط عندما تتحقق من الفوترة.
الحقول غير المعروفة تمر صامتة
Section titled “الحقول غير المعروفة تمر صامتة”الجسم يقبل المفاتيح الزائدة ويتجاهلها. الاستثناء فقط للكتابات المختصرة المرفوضة صراحةً (lat، tz وغيرها، انظر تنسيقات الحقول). لذلك عادةً خطأ إملائي في اسم الحقل لن يُظهر نفسه: ستحصل على 200 وخريطة محسوبة بدون معاملك.
فوق الدائرة القطبية يتم استبدال نظام المنازل
Section titled “فوق الدائرة القطبية يتم استبدال نظام المنازل”في الأنظمة الربعية عندما |latitude| > 66.5° تُحسب الكواكب كـ Porphyry، لأن هذه الأنظمة غير معرفة هناك. نحن لا نخفي ذلك: يظهر حقل warning في الاستجابة. نظاما Whole Sign و Equal يعملان على أي خط عرض.
الحالة المجاورة أغلقناها بالرفض: الكود غير المعروف houseSystem لم يعد يُعطي Placidus تحت اسم آخر، بل يُعيد 400.
المفتاح لديه ثلاث حدود مستقلة
Section titled “المفتاح لديه ثلاث حدود مستقلة”المفتاح المتصفح pk_ والمفتاح السري aw_ يمكن أن يحملوا ثلاث قيود في آن واحد، ولا يستبدل أحدهما الآخر:
| الحد | ما يقال | الرفض |
|---|---|---|
| قائمة النطاقات | من أين يمكن الاستدعاء | 403 ORIGIN_REQUIRED / ORIGIN_NOT_ALLOWED |
credits_cap_cycle | كم يمكن لهذا المفتاح إنفاقه | 429 KEY_BUDGET_EXHAUSTED |
allowed_endpoints | ما يمكن استدعاؤه بالضبط | 403 ENDPOINT_NOT_IN_SCOPE |
نطاق الـ endpoints لا يعفي من القراءات الخدمية: المفتاح المحدد إلى embed/* لن يقرأ حتى إحصائياته الخاصة. هذا مقصود، التفاصيل في المصادقة.
تعديل المفتاح يبدأ من الطلب التالي
Section titled “تعديل المفتاح يبدأ من الطلب التالي”المفاتيح تُخزن في الذاكرة لمدة 60 ثانية، لكن أي تعديل عبر PATCH /v1/keys/{id} يفرغ الذاكرة فورًا. لا حاجة للانتظار دقيقة.