/v1/fetch-document
5 kredit • 5/percTöltsön le hivatalos PDF dokumentumokat a német kereskedelmi nyilvántartásból.
Paraméterek
| Név | Típus | Kötelező | Leírás |
|---|---|---|---|
| api_key | string | Feltételes* | Az API kulcsod. Kötelező, ha nem használsz x-api-key fejlécet vagy Bearer tokent |
| company_id | string | KÖTELEZŐ | Egyedi vállalati entitás azonosító a keresési eredményekből |
| document_type | string | KÖTELEZŐ | Dokumentum típus. Értékek: shareholders_list, articles_of_association, AD, CD, SI |
Példa kérés
curl 'https://handelsregister.ai/api/v1/fetch-document?api_key=your_api_key_here&company_id=20a1510e88cd2e9b166db4d0bc5d563d&document_type=shareholders_list' \
-o document.pdf
Válasz
Sikeres (200): PDF fájlt ad vissza közvetlenül
Content-Type: application/pdf · application/xml (application/pdf für AD, CD, shareholders_list, articles_of_association — application/xml für SI.)
Hiba: JSON-t ad vissza hiba részletekkel
504 Antwortet das Handelsregister nicht rechtzeitig, liefert die API 504 mit Retry-After-Header. Das Dokument kann trotzdem existieren: Wiederhole den Abruf frühestens nach 60 Sekunden, mit wachsendem Abstand (z. B. 1, dann 5 Minuten). Fehlgeschlagene Abrufe kosten keine Credits. 404 bedeutet: Das Dokument ist für diese Firma nicht verfügbar.
Dokumentum típusok
shareholders_list
Részvényesi nyilvántartási dokumentum
articles_of_association
Gesellschaftsvertrag / Satzung / Statut
AD
Aktuális kivonatok (Aktuelle Daten)
CD
Történeti kivonatok (Chronologische Daten)
SI
Strukturierter Registerinhalt — wird als XML-Datei geliefert.