# الأخطاء الشائعة تم إنشاء هذه الصفحة من خلال توزيع الحالات على مدار 30 يومًا. حيث لا نقيس شيئًا، نكتب ذلك صراحة. ## أخطاء المسار أشهر أخطاء 4xx في السجل هي `404`، ومعظمها ليست منك: إنها مسح تلقائي يبحث عن `.env`، `.git/config`، `wordpress/`، `wp-content/…`. أخطاء المسار الحقيقية من قبل المطورين مختلفة، وقد تم وصفها أمثلة هنا: [المكالمات الخاطئة التي نراها غالبًا](/api-conventions/#помилкові-виклики-які-ми-بشیمو-نأیست). باختصار: `/api/…` بدلًا من `/v1/…`، مكرر `/v1/v1/…`، `/swagger.json` بدلًا من `/v1/openapi.json`. ## `402`: الخطة لا تشمل نقطة النهاية 385 ردًا في 30 يومًا. التوزيع يوضح أين يواجه الخطة المجانية مشاكل بشكل متكرر: | نقطة النهاية | `402` في 30 يومًا | |---|---| | `chart` | 114 | | `transit-calendar` | 101 | | `vedic/dashas/vimshottari/maha` | 48 | | `ingresses` | 25 | | `planetary-hours` | 24 | | `vedic/panchang/full` | 24 | | `eclipses` | 13 | في نص الاستجابة تأتي `current_plan` و `upgrade_to`. هذا ليس خطأ في الطلب: النص صحيح، المميز صالح، ببساطة الخطة لا تشمل هذه النقطة النهائية. ## `429`: حدان مختلفان 6,791 ردًا في 30 يومًا، منها 3,769 بدون مفتاح و3,022 بمفتاح. هذه آليتان مختلفتان، ولا يجب الخلط بينهما: - **بدون مفتاح** الحد يُحسب حسب IP، 30 طلبًا في الساعة. أكبر كتلة في سجلنا ليست المطورون، بل تدقيق Chrome-Lythe الاصطناعي من 15 عنوانًا؛ - **بمفتاح** الحد هو RPM لخطةك. في الاستجابة يوجد `Retry-After` بالثواني، ويجب انتظاره بدلاً من إعادة المحاولة فورًا. ## `400`: غالبًا ما يكون نص الطلب 700 ردًا في 30 يومًا، وهي مركزة على نقاط النهاية التي تقبل التاريخ والوقت والإحداثيات: `chart` (111)، `horoscope/daily` (19)، `transits` (18)، `synastry` (15)، `rectification` (15). أغلى هذه الأخطاء ليست التي تعطي `400`، بل تلك التي أعطت يومًا ما `200`: كتابة مختصرة للحقول. القواعد ومثال الاستجابة: [تنسيقات الحقول](/agent-setup/field-formats/). ## `401` و `403` `401` هو مفتاح مفقود أو غير صحيح؛ الرسالة تسمي كلتا الفئتين، `aw_` و `pk_`. `403` هو الأصل: مفتاح المتصفح `pk_` يُرفض إذا جاء الطلب بدون أصل أو من نطاق أجنبي، ومفتاح نطاق نقطة النهاية يُعطي `ENDPOINT_NOT_IN_SCOPE` ويقوم بإنشاء قائمته الخاصة في `details`. جدول كامل للرموز: [الأخطاء](/errors/).