توثيق واجهة برمجة التطبيقات

احصل على إشعارات الإعسار الألمانية اليومية عبر واجهة REST الخاصة بنا وعالجها تلقائيًا في أنظمتك.

المصادقة

يتطلب كل طلب مفتاح واجهة برمجة التطبيقات الخاص بك في ترويسة X-API-Key. تُصدر المفاتيح بعد تفعيل وصولك إلى الواجهة.

X-API-Key: YOUR_API_KEY

نقطة النهاية

تُرجع نقطة نهاية GET واحدة إشعارات يوم محدد أو نطاق زمني.

GET https://germanyinsolvencies.com/api/v1/filings

المعاملات

جميع المعاملات اختيارية. بدون تحديد تاريخ، يُرجَع اليوم السابق. الحد الأقصى للنطاق هو 31 يومًا لكل طلب.

Parameter	Description
date	Single day, format `YYYY-MM-DD`. Defaults to yesterday.
date_from / date_to	Date range (max. 31 days per request).
types	Comma-separated list of type aliases or codes. Omit for all types.
format	`json` (default) or `csv`.

أنواع الإشعارات

قم بالتصفية عبر المعامل types. افصل القيم المتعددة بفواصل؛ واترك الحقل فارغًا لتلقي جميع الأنواع.

types=	Code	Bekanntmachungsart
sicherung	0	Sicherungsmaßnahmen / Protective measures
abweisung	1	Abweisungen mangels Masse / Dismissal for lack of assets
eroeffnung	2	Eröffnungen / Opening of proceedings
entscheidung	3	Entscheidungen im Verfahren / Decisions in proceedings
sonstiges	4	Sonstiges / Other
entscheidung_aufhebung	5	Entscheidungen nach Aufhebung / Decisions after termination
verteilungsverzeichnis	6	Verteilungsverzeichnisse (§ 188 InsO) / Distribution lists
restschuldbefreiung	7	Restschuldbefreiung / Discharge of residual debt
insolvenzplan	8	Überwachte Insolvenzpläne / Supervised insolvency plans

مثال على الطلب

مثال: جميع حالات الافتتاح والتدابير التحفظية والرفض ليوم واحد بصيغة JSON.

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://germanyinsolvencies.com/api/v1/filings?date=2026-06-08&types=eroeffnung,sicherung,abweisung"

الاستجابة

تحتوي الاستجابة على عدد النتائج ومصفوفة من الإشعارات. استخدم format=csv لتلقي ملف CSV بدلاً من ذلك.

{
  "date_from": "2026-06-08",
  "date_to": "2026-06-08",
  "types": ["0", "1", "2"],
  "count": 142,
  "filings": [
    {
      "date": "2026-06-08",
      "type": "Eröffnungen",
      "type_code": "2",
      "name": "Beispiel GmbH",
      "sitz": "Berlin",
      "court": "Charlottenburg (Berlin)",
      "aktenzeichen": "36a IN 1234/26",
      "bundesland": "Berlin",
      "register": "HRB 12345",
      "text": "Im Insolvenzverfahren ..."
    }
  ]
}

الأخطاء

تُرجَع الأخطاء بصيغة JSON مع رمز حالة HTTP المناسب.

HTTP	error
401	missing_api_key
403	invalid_api_key, subscription_expired
400	bad_date, bad_type, range_too_large
500	server_error

الحصول على الوصول

يُوفَّر الوصول إلى الواجهة بشكل فردي. تواصل معنا موضحًا حالة الاستخدام وسنقوم بإعداد مفتاحك.

اتصل بنا