مرجع الأخطاء
يتضمن محتوى كل خطأ code ورسالة message واضحة وrequest_id وقائمة remedies. يربط حقل docs بمدخل الرمز في هذه الصفحة.
invalid_request (400)
إحدى المعلمات مفقودة أو غير صحيحة الصياغة. تذكر الرسالة اسم المعلمة. صحّح الطلب وأرسله مجددًا.
unauthorized (401)
تضمّن الطلب مفتاح API بتنسيق غير صحيح، أو ملغى، أو يفتقر إلى نطاق الصلاحيات الذي يتطلبه المسار. يعمل كل مسار بيانات أيضًا دون مفتاح: احذف ترويسة Authorization لاستخدام حدود الاستخدام دون مفتاح. لم تُتح المفاتيح للجمهور بعد. راجع مفاتيح API.
payment_required (402)
لا يُرجع هذه الاستجابة إلا المضيف agent.financial.md. يتطلب المسار المدفوع هناك سدادًا: تتضمن ترويسة PAYMENT-REQUIRED السعر والشروط. ادفع باستخدام x402 وأرسل الاستدعاء مجددًا، أو استدعِ المسار نفسه على api.financial.md دون مفتاح، ضمن الحدود اليومية. راجع التسعير.
unknown_company (404)
لم تتطابق أي شركة مع المعلمة company. جرّب CIK (cik:320193) أو ابحث باستخدام GET /v1/companies?q=. لا يمكن البحث عن شركة مشطوبة من الإدراج برمز تداولها: استخدم CIK الخاص بها. يسرد GET /v1/companies?status=delisted هذه الشركات.
unknown_concept (404)
معرّف البند أو النسبة غير موجود في قالب الشركة. يسرد GET /v1/company/metrics المعرّفات.
not_found (404)
المسار أو معرّف الإيداع لدى SEC (المستند المودَع) أو معرّف الإثبات غير موجود. تحقّق من رقم الإيداع أو معرّف الإثبات.
not_covered (404)
الشركة معروفة، لكن مجموعة البيانات هذه غير متاحة لها. يسرد متن الاستجابة available_datasets. تتوفر للجهة التي تُعدّ تقاريرها وفق IFRS إيداعات لدى SEC (المستندات المودَعة)، لكن لا تتوفر لها قوائم مالية موحّدة بعد.
rate_limited (429)
استُنفد الحد اليومي لهذه الفئة من المسارات. انتظر عدد الثواني المحدد في Retry-After. الحدود موضحة في صفحة التوثيق. لم تُتح مفاتيح بحدود أعلى بعد.
upstream_unavailable (503)
تعذّر على API الوصول إلى قاعدة بياناته. أعد المحاولة بعد انتظار قصير. يساعدنا request_id في العثور على الاستدعاء.