REST-API · POST /check/batch · kostenpflichtig
Anfrage
So rufen Sie die Route auf
Adresse: POST https://einvoicetools.de/wp-json/einvoice-api/v1/check/batch
Schlüssel: Senden Sie Ihren API-Schlüssel in der Kopfzeile Authorization: Bearer <Schlüssel>. Ohne gültigen Schlüssel antwortet die Route mit dem Status 401.
Inhalt: Der Inhalt der Anfrage ist JSON mit dem Feld items: eine Liste mit bis zu 1.000 Einträgen, jeder wie bei POST /check mit scheme, value und wahlweise context.
Antwort
Was zurückkommt
results – Ein Ergebnis je Kennung, in derselben Reihenfolge, jedes mit denselben Feldern wie bei POST /check.
status – valid, invalid oder unknown, wenn das Register gerade keine Auskunft gibt.
Wenn etwas nicht geht
Status 400 – Die Liste ist leer oder hat mehr als 1.000 Einträge.
Status 401 – Der Schlüssel fehlt, ist unbekannt oder gesperrt.
Status 429 – Der Stapel würde das restliche Kontingent überschreiten. Dann wird nichts geprüft und nichts gezählt.
Beispiel
Ein Aufruf mit curl
curl -X POST "https://einvoicetools.de/wp-json/einvoice-api/v1/check/batch" \
-H "Authorization: Bearer <Schlüssel>" \
-H "Content-Type: application/json" \
-d '{"items":[{"scheme":"vat","value":"DE136695976"},{"scheme":"lei","value":"529900T8BM49AURSDO55"}]}'
Kosten
Kontingent und Tarif
Die Route ist kostenpflichtig. Jede geprüfte Kennung zählt als eine Kennungsprüfung gegen das Monatskontingent Ihres Tarifs. Zum Ausprobieren gibt es den kostenlosen Tarif „Frei“ mit eigenem Schlüssel; er reicht für etwa zwei Kennungsprüfungen am Tag. Antworten mit einem Fehlerstatus zählen nicht.
Ein Stapel wird als Ganzes angenommen oder abgewiesen. Gezählt wird jede Kennung einzeln: Ein Stapel mit 100 Kennungen zählt 100 Kennungsprüfungen.