الأخطاء الشائعة

تم إنشاء هذه الصفحة من خلال توزيع الحالات على مدار 30 يومًا. حيث لا نقيس شيئًا، نكتب ذلك صراحة.

ملاحظة

نحن لا نكتب رموز الأخطاء في سجل الطلبات، فقط حالات HTTP. لذلك، أدناه توجد تكرارات الحالات، لكن لا يوجد تصنيف للرموز مثل INVALID_FIELD. لم نقرر ابتكاره.

أخطاء المسار

أشهر أخطاء 4xx في السجل هي 404، ومعظمها ليست منك: إنها مسح تلقائي يبحث عن .env، .git/config، wordpress/، wp-content/…. أخطاء المسار الحقيقية من قبل المطورين مختلفة، وقد تم وصفها أمثلة هنا: المكالمات الخاطئة التي نراها غالبًا. باختصار: /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: كتابة مختصرة للحقول. القواعد ومثال الاستجابة: تنسيقات الحقول.

401 و 403

401 هو مفتاح مفقود أو غير صحيح؛ الرسالة تسمي كلتا الفئتين، aw_ و pk_. 403 هو الأصل: مفتاح المتصفح pk_ يُرفض إذا جاء الطلب بدون أصل أو من نطاق أجنبي، ومفتاح نطاق نقطة النهاية يُعطي ENDPOINT_NOT_IN_SCOPE ويقوم بإنشاء قائمته الخاصة في details.

جدول كامل للرموز: الأخطاء.