تنزيل المستندات

مستخرجات السجل وقوائم الشركاء وعقود التأسيس كملفات.

1

اختيار نوع المستند

document_type
document_type المستند الصيغة لـ
AD Aktueller Abdruck (المستخرج الحالي): جميع القيود السارية اليوم PDF كل شركة مسجلة
CD Chronologischer Abdruck (المستخرج الزمني): جميع القيود بترتيب زمني PDF كل شركة مسجلة
SI Strukturierter Registerinhalt (محتوى السجل المنظّم) بصيغة XJustiz، قابل للقراءة آليًا XML كل شركة مسجلة
shareholders_list Gesellschafterliste (قائمة الشركاء) PDF GmbH وUG
articles_of_association Satzung أو Gesellschaftsvertrag (عقد التأسيس) PDF شركات الأموال والتعاونيات
2

جلب مستند

curl -G "https://handelsregister.ai/api/v1/fetch-document" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "company_id=94eb910fef13f94585c48c263fa446d4" \
  --data-urlencode "document_type=AD" \
  --fail-with-body --max-time 120 \
  -o hetzner-ad.pdf
الحقل
الحقل المعنى
Content-Type application/pdf، ولمحتوى السجل المنظّم application/xml.
Content-Disposition اسم الملف مع entity_id والنوع واليوم الذي جاء فيه المستند من السجل.
X-Credits-Charged تكلفة الطلب.
X-Credits-Remaining رصيدك بعد ذلك.
1{2  "error": "Document fetch failed",3  "message": "Document not available for this company. It may not exist or may become available later.",4  "meta": {5    "request_credit_cost": 0,6    "credits_remaining": 1457  }8}
404 · مثال على استجابة لقائمة الشركاء لتاجر فرد
تجلب الـ API المستندات من السجل عند الحاجة. وقد يستغرق ذلك حتى دقيقتين. اضبط مهلة الانتظار في عميلك على 120 ثانية على الأقل أو اجلب المستند في الخلفية.
3

الجلب في الخلفية

curl -G "https://handelsregister.ai/api/v1/fetch-document" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode 'company_id=e3918174fb6c5d04e5e217e6ee4a6ffe' \
  --data-urlencode 'document_type=CD' \
  --data-urlencode 'async=true'
1{2  "status": "processing",3  "meta": {4    "message": "The document is being retrieved. Repeat this request after Retry-After seconds to receive it.",5    "retry_after": 20,6    "request_credit_cost": 0,7    "credits_remaining": 1458  }9}
202 · مثال على استجابة أثناء جلب Chronologischer Abdruck لـ SAP SE

التكاليف والحدود

التكاليف والحدود
ماذا الأرصدة
مستند واحد تم تسليمه 15

الحد: 5 طلب في الدقيقة. يتشارك البحث والمستندات وSignals حصة واحدة من 60 طلب في الدقيقة.

إذا تعذّر الوصول إلى السجل التجاري حاليًا أو استجاب ببطء شديد، تحصل على HTTP 504 مع Retry-After. ولا تحتسب الـ API شيئًا. حاول مرة أخرى بعد بضع دقائق.

أخطاء شائعة

التالي