# العقبات

لا شيء مما سبق هو خطأ. هذه سلوكيات من الأفضل معرفتها من الوثائق بدلاً من تحليل رد شخص آخر.

## في الاستجابة يوجد حقل إضافي `_footer`

الخطة المجانية و**أي** استدعاء بدون مفتاح يحصل على حقل إضافي `_footer` في الجسم يحتوي على توقيع. المفاتيح المدفوعة لا تراه. إذا كان المحلل الخاص بك صارماً فيما يتعلق بالحقول الزائدة، فهذه هي أول نقطة سيعثر عليها.

## الاستدعاء المتكرر نفسه يكلف صفر

الطلب الم خلال فترة التخزين المؤقت يعيد `X-Cache: HIT`، ولا يخصم **الرصيد** من هذا الاستدعاء: في الاستجابة `X-Credits-Used: 0`، والرصيد المتبقي يعاد. أي لا يمكنك قياس التكلفة عن طريق تشغيل نفس الطلب مرارًا وتكرارًا: سيدفع مرة واحدة فقط.

## مفتاح Sandbox لا ينفق أي شيء

`aw_test_*` لا يخصم الرصيد على الإطلاق ولا يدخل في حد الحساب. هذا ليس "حصة صغيرة"، بل صفر. يجب عليك التطوير عليه بالضبط، واستخدام `aw_live_*` عند التحقق من الفوترة.

## الحقول غير المعروفة تمر بصمت

الجسم يقبل المفاتيح الزائدة ويهملها. الاستثناء فقط للصيغ المختصرة المرفوضة بوضوح (`lat`، `tz` والباقي، انظر [صيugins الحقول](/agent-setup/field-formats/)). لذلك الخطأ الإملائي في اسم الحقل عادة لن يلاحظ: ستحصل على `200` وخريطة محسوبة بدون معاملك.

<Aside type="caution">
أغلى حالة من هذا النوع: `city` يبدو كعنوان ولكنه لا يقوم بعملية ترميز جغرافي. بدون `latitude` و `longitude` لن تكون هناك خريطة.
</Aside>

## فوق دائرة القطب الشمالي يتم استبدال نظام المنازل

لأنظمة الربعية عند `|latitude| > 66.5°` يعيد Swiss Ephemeris Porphyry بصمت. لا نخفي ذلك: يظهر حقل `warning` في الاستجابة. نظام Whole Sign و Equal يعملان على أي خط عرض.

الحالة المجاورة أغليناها بالرفض: كود `houseSystem` غير المعروف لم يعود يعطي Placidus باسم آخر، بل يعيد `400`.

## للمفتاح ثلاث حدود مستقلة

مفتاح المتصفح `pk_` والمفتاح السري `aw_` يمكن أن يحملان ثلاث قيود في وقت واحد، ولا يحل أحدهما محل الآخر:

| الحد | ما يقوله | الرفض |
|---|---|---|
| قائمة النطاقات | من يمكن استدعاؤه من | `403 ORIGIN_REQUIRED` / `ORIGIN_NOT_ALLOWED` |
| `credits_cap_cycle` | كم يمكن لهذا المفتاح إنفاقه | `429 KEY_BUDGET_EXHAUSTED` |
| `allowed_endpoints` | ما يمكن استدعاؤه بالضبط | `403 ENDPOINT_NOT_IN_SCOPE` |

نطاق نقاط النهاية **لا** يحرر القراءات الخدمية: المفتاح المحدود إلى `embed/*` لن يقرأ إحصاءاته الخاصة. هذا متعمد، التفاصيل في [المصادقة](/authentication/).

## تعديل المفتاح يبدأ من الطلب التالي

المفاتيح مخزنة مؤقتًا لمدة 60 ثانية، ولكن أي تغيير عبر `PATCH /v1/keys/{id}` يعيد تعيين التخزين المؤقت على الفور. لا داعي لانتظار دقيقة.