API-Referenz

Vollständige Endpoint-Liste für beide CrateAPI-Produkte: curl-Beispiele, Antworten, Authentifizierung, Limits. Endpoint-Pfade, curl-Beispiele, Parameter- und Profilnamen sowie JSON-Payloads bleiben durchgehend auf Englisch - copy-paste-fertiger Code muss nicht übersetzt werden.

Authentifizierung

E-Invoicing-Basis-URL: https://api.crateapi.com/v1. Document-Tools-Basis-URL: https://api.crateapi.com (Pfade /pdf, /screenshot, /email, /extract). Senden Sie Ihren Schlüssel als X-API-Key: <Ihr Schlüssel>. Mit kostenlos markierte Endpoints benötigen überhaupt keinen Schlüssel - das ist Absicht, kein Test: Validierung bleibt für immer kostenlos.

curl -X POST https://api.crateapi.com/v1/validate/ubl \
     -H "Content-Type: application/xml" \
     --data-binary @invoice.xml

{"profile":"peppol","valid":true,"counts":{"fatal":0,"warning":0},"findings":[],"duration_ms":12}

curl -X POST https://api.crateapi.com/v1/generate/ubl?profile=peppol \
     -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
     -d @invoice.json -o invoice.xml

E-Invoicing-API

EN 16931: UBL/Peppol BIS, CII, Factur-X, FatturaPA (Italien: TD01/TD04/TD05-Rechnungen und Gutschriften, Natura-Codes inkl. forfettario), Order-X (Bestellungen). Vollständige OpenAPI-Spezifikation: /openapi.json · interaktive Doku: /docs (Swagger UI).

Endpoint	Auth	Hinweise
`POST /v1/validate/ubl`	kostenlos	Validiert eine UBL-Rechnung. `profile`: en16931, peppol, xrechnung, ro, fr, fr-extended.
`POST /v1/validate/cii`	kostenlos	Validiert eine CII-Rechnung. `profile`: en16931, xrechnung, fr, fr-extended.
`POST /v1/validate/facturapa`	kostenlos	Nur XSD-Strukturvalidierung für FatturaPA (kein offizielles Schematron-Regelwerk zum Vendorisieren vorhanden).
`POST /v1/validate/orderx`	kostenlos	Order-X Basic - vollständige XSD- + offizielle Schematron-Validierung.
`POST /v1/pdfa/validate`	kostenlos	PDF/A-Validierung (veraPDF). `flavour`: auto\|1a\|1b\|2a\|2b\|2u\|3a\|3b\|3u\|4\|4e\|4f.
`GET /validator`	kostenlos	Drag-and-drop-Validator im Browser, gleiche Engine, keine Anmeldung.
`POST /v1/generate/ubl`	X-API-Key erforderlich	JSON-Rechnungsmodell → UBL-XML. `profile`: en16931, peppol, xrechnung, ro.
`POST /v1/generate/cii`	X-API-Key erforderlich	JSON-Rechnungsmodell → CII-XML. `profile`: en16931, xrechnung.
`POST /v1/generate/facturx`	X-API-Key erforderlich	Unser minimalistisches visuelles PDF + eingebettetes CII-XML (EN16931).
`POST /v1/generate/facturx/embed`	X-API-Key erforderlich	Ihr gebrandetes PDF + Rechnungs-JSON → PDF/A-3 mit eingebettetem CII (multipart).
`POST /v1/generate/facturapa`	X-API-Key erforderlich	FatturaPA-XML (Italien): TD01-Rechnungen, TD04/TD05-Gutschriften/Lastschriften, Natura-USt-Befreiungscodes (inkl. Kleinunternehmerregelung forfettario N2.2), optional ritenuta/bollo/cassa.
`POST /v1/generate/orderx`	X-API-Key erforderlich	Order-X-Basic-Bestellungs-XML (keine Rechnung).
`POST /v1/convert/ubl-to-cii`	X-API-Key erforderlich	Verlustfrei oder abgelehnt: 422 mit Details statt stillem Qualitätsverlust.
`POST /v1/convert/cii-to-ubl`	X-API-Key erforderlich	Gleiche Garantie, andere Richtung.
`POST /v1/render/html`	X-API-Key erforderlich	Rechnungs-XML → menschenlesbares HTML (offizielle KoSIT-Visualisierung).
`POST /v1/render/pdf`	X-API-Key erforderlich	Rechnungs-XML → PDF. `style`: compact (Standard, 1 Seite) oder kosit (Prüfformular).
`POST /v1/pdfa/convert`	X-API-Key erforderlich	Beliebiges PDF → PDF/A-3b, mit optional eingebetteten Dateien.
`POST /v1/pdfa/consistency`	X-API-Key erforderlich	Factur-X: Stimmt das eingebettete XML mit dem sichtbaren PDF-Text überein?
`POST /v1/repair/ubl`	X-API-Key erforderlich	Best-effort-Auto-Reparatur: nicht-ISO-Datumsformate, Rundungsabweichungen bei Summen.
`POST /v1/repair/cii`	X-API-Key erforderlich	Gleiches Prinzip, CII-Syntax.

Document-Tools-API

PDF, Screenshot, E-Mail-Validierung, Inhaltsextraktion. Auth: über RapidAPI (Listing ausstehend) oder für direkten Zugang kontaktieren Sie uns. Einzelne API-Spezifikationen: /pdf/openapi.json, /screenshot/openapi.json, /email/openapi.json, /extract/openapi.json.

API	Endpoint	Hinweise
pdf	`POST /pdf/merge`	Kombiniert 2+ PDFs in Upload-Reihenfolge.
pdf	`POST /pdf/split`	Extrahiert Seiten, z. B. `pages=1-3,5`.
pdf	`POST /pdf/watermark`	Diagonales Text-Overlay - `text`, `opacity`, `color`, `font_size`.
pdf	`POST /pdf/protect`	AES-256-Passwortverschlüsselung.
pdf	`POST /pdf/compress`	Ghostscript-Rekomprimierung - `level`: low\|medium\|high; liefert nie eine größere Datei als die Eingabe.
pdf	`POST /pdf/from-html`	Rohes HTML → PDF (Headless-Chromium).
pdf	`POST /pdf/from-url`	Öffentliche URL → PDF, gleicher Anti-SSRF-Schutz wie /screenshot.
pdf	`POST /pdf/to-images`	Seiten → PNG/JPEG, als ZIP zurückgegeben.
pdf	`POST /pdf/extract-text`	Layout-bewusste Textextraktion (poppler, Fallback pypdf).
pdf	`POST /pdf/metadata`	Seitenzahl, Verschlüsselungsstatus, Dokument-Infofelder.
screenshot	`GET /screenshot/take`	URL → PNG/JPEG. `block_ads`, `block_trackers`, `block_cookie_banners`, `cache_ttl`, `full_page`, `delay_ms`.
email	`GET /email/validate`	Syntax- + MX- + Wegwerf- + Funktionskonto- + Freemail-Signale, mit einem Score.
email	`POST /email/validate-batch`	Bis zu 100 Adressen, JSON-Body.
email	`POST /email/validate-bulk`	CSV-Upload, bis zu 5.000 Adressen; `format=json` oder `format=csv` (Ergebnisse angehängt).
extract	`GET /extract/article`	URL → bereinigter Artikeltext + Metadaten, ohne Boilerplate.
extract	`POST /extract-html`	Rohes HTML → bereinigter Text (kein Abruf).

Limits

E-Invoicing: XML-Body auf 2 MB begrenzt, PDF-Uploads auf 10 MB. Das monatliche Kontingent pro Schlüssel (planabhängig kalibriert, großzügiger Standard - siehe Preise) gilt für jeden Endpoint außer /validate/* und /pdfa/validate, die unbegrenzt bleiben.

Document Tools: 100 Anfragen/Monat im kostenlosen Plan, bis zu 50.000/Monat bei Ultra - siehe Preise. Bulk-E-Mail-Validierung ist auf 5.000 Adressen / 2 MB pro Upload begrenzt.

MCP-Server (KI-Agenten)

Selbst gehostet, funktioniert schon heute mit Ihrem eigenen API-Schlüssel - kein Warten auf einen gehosteten Endpoint nötig:

{"mcpServers": {"crateapi-einvoicing": {
    "command": "python", "args": ["-m", "einvoicing.mcp_server"],
    "env": {"EINVOICE_API_KEY": "your-key-here"}}}}

Tools: validate_invoice (kostenlos), repair_invoice, generate_invoice, convert_invoice. Maschinenlesbare Zusammenfassung dieser gesamten Seite: /llms.txt · /ai (JSON).