العقبات
لا شيء مما سبق هو خطأ. هذه سلوكيات من الأفضل معرفتها من الوثائق بدلاً من تحليل رد شخص آخر.
في الاستجابة يوجد حقل إضافي _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 والباقي، انظر صيugins الحقول). لذلك الخطأ الإملائي في اسم الحقل عادة لن يلاحظ: ستحصل على 200 وخريطة محسوبة بدون معاملك.
فوق دائرة القطب الشمالي يتم استبدال نظام المنازل
Section titled “فوق دائرة القطب الشمالي يتم استبدال نظام المنازل”لأنظمة الربعية عند |latitude| > 66.5° يعيد Swiss Ephemeris 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 |
نطاق نقاط النهاية لا يحرر القراءات الخدمية: المفتاح المحدود إلى embed/* لن يقرأ إحصاءاته الخاصة. هذا متعمد، التفاصيل في المصادقة.
تعديل المفتاح يبدأ من الطلب التالي
Section titled “تعديل المفتاح يبدأ من الطلب التالي”المفاتيح مخزنة مؤقتًا لمدة 60 ثانية، ولكن أي تغيير عبر PATCH /v1/keys/{id} يعيد تعيين التخزين المؤقت على الفور. لا داعي لانتظار دقيقة.