Referință API
Lista completă de endpoint-uri pentru ambele produse CrateAPI: exemple curl, răspunsuri, autentificare, limite. Căile de endpoint, exemplele curl, numele de parametri și profiluri, precum și payload-urile JSON rămân în engleză peste tot - codul de copy-paste nu are nevoie de traducere.
Autentificare
URL de bază e-invoicing: https://api.crateapi.com/v1. URL de bază document tools: https://api.crateapi.com (căile /pdf, /screenshot, /email, /extract). Trimiteți cheia ca X-API-Key: <cheia dvs.>. Endpoint-urile marcate gratuit nu au nevoie de nicio cheie - e intenționat, nu un trial: validarea rămâne gratuită pentru totdeauna.
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
API e-invoicing
EN 16931: UBL/Peppol BIS, CII, Factur-X, FatturaPA (Italia: facturi și note de credit/debit TD01/TD04/TD05, coduri Natura incl. forfettario), Order-X (comenzi de achiziție). Specificația OpenAPI completă: /openapi.json · documentație interactivă: /docs (Swagger UI).
| Endpoint | Autentificare | Note |
|---|---|---|
POST /v1/validate/ubl | gratuit | Validează o factură UBL. `profile`: en16931, peppol, xrechnung, ro, fr, fr-extended. |
POST /v1/validate/cii | gratuit | Validează o factură CII. `profile`: en16931, xrechnung, fr, fr-extended. |
POST /v1/validate/facturapa | gratuit | Doar validare structurală XSD pentru FatturaPA (nu există un set oficial de reguli schematron de vendorizat). |
POST /v1/validate/orderx | gratuit | Order-X Basic - validare completă XSD + schematron oficial. |
POST /v1/pdfa/validate | gratuit | Validare PDF/A (veraPDF). `flavour`: auto|1a|1b|2a|2b|2u|3a|3b|3u|4|4e|4f. |
GET /validator | gratuit | Validator drag-and-drop în browser, același motor, fără cont. |
POST /v1/generate/ubl | necesită X-API-Key | Model de factură JSON → XML UBL. `profile`: en16931, peppol, xrechnung, ro. |
POST /v1/generate/cii | necesită X-API-Key | Model de factură JSON → XML CII. `profile`: en16931, xrechnung. |
POST /v1/generate/facturx | necesită X-API-Key | PDF-ul nostru vizual minimal + XML CII încorporat (EN16931). |
POST /v1/generate/facturx/embed | necesită X-API-Key | PDF-ul dvs. cu brandul propriu + JSON de factură → PDF/A-3 cu CII încorporat (multipart). |
POST /v1/generate/facturapa | necesită X-API-Key | XML FatturaPA (Italia): facturi TD01, note de credit/debit TD04/TD05, coduri Natura de scutire TVA (incl. forfettario N2.2), ritenuta/bollo/cassa opționale. |
POST /v1/generate/orderx | necesită X-API-Key | XML de comandă Order-X Basic (nu e factură). |
POST /v1/convert/ubl-to-cii | necesită X-API-Key | Fără pierderi sau respins: 422 cu detalii, nu o degradare silențioasă. |
POST /v1/convert/cii-to-ubl | necesită X-API-Key | Aceeași garanție, în sens invers. |
POST /v1/render/html | necesită X-API-Key | XML de factură → HTML lizibil (vizualizare oficială KoSIT). |
POST /v1/render/pdf | necesită X-API-Key | XML de factură → PDF. `style`: compact (implicit, 1 pagină) sau kosit (formular de audit). |
POST /v1/pdfa/convert | necesită X-API-Key | Orice PDF → PDF/A-3b, cu fișiere încorporate opționale. |
POST /v1/pdfa/consistency | necesită X-API-Key | Factur-X: XML-ul încorporat corespunde cu textul vizibil din PDF? |
POST /v1/repair/ubl | necesită X-API-Key | Auto-reparare best-effort: date non-ISO, deviații aritmetice la totaluri. |
POST /v1/repair/cii | necesită X-API-Key | Același lucru, sintaxă CII. |
API Document Tools
PDF, screenshot, validare email, extracție de conținut. Autentificare: prin RapidAPI (listare în așteptare) sau contactați-ne pentru acces direct. Specificații per API: /pdf/openapi.json, /screenshot/openapi.json, /email/openapi.json, /extract/openapi.json.
| API | Endpoint | Note |
|---|---|---|
POST /pdf/merge | Combină 2+ PDF-uri, în ordinea încărcării. | |
POST /pdf/split | Extrage pagini, ex. `pages=1-3,5`. | |
POST /pdf/watermark | Suprapunere text diagonal - `text`, `opacity`, `color`, `font_size`. | |
POST /pdf/protect | Criptare cu parolă AES-256. | |
POST /pdf/compress | Recompresie Ghostscript - `level`: low|medium|high; nu returnează niciodată un fișier mai mare decât cel original. | |
POST /pdf/from-html | HTML brut → PDF (Chromium headless). | |
POST /pdf/from-url | URL public → PDF, aceeași protecție anti-SSRF ca /screenshot. | |
POST /pdf/to-images | Pagini → PNG/JPEG, returnate ca ZIP. | |
POST /pdf/extract-text | Extracție de text sensibilă la layout (poppler, fallback pypdf). | |
POST /pdf/metadata | Număr de pagini, flag de criptare, câmpuri de metadate document. | |
| screenshot | GET /screenshot/take | URL → PNG/JPEG. `block_ads`, `block_trackers`, `block_cookie_banners`, `cache_ttl`, `full_page`, `delay_ms`. |
GET /email/validate | Semnale sintaxă + MX + adresă disposable + cont de rol + furnizor gratuit, cu un scor. | |
POST /email/validate-batch | Până la 100 de adrese, body JSON. | |
POST /email/validate-bulk | Upload CSV, până la 5.000 de adrese; `format=json` sau `format=csv` (rezultate adăugate). | |
| extract | GET /extract/article | URL → text de articol curățat + metadate, fără elemente reziduale. |
| extract | POST /extract-html | HTML brut → text curățat (fără fetch). |
Limite
E-invoicing: body XML plafonat la 2 MB, upload-uri PDF la 10 MB. Cota lunară per cheie (calibrată per plan, generoasă implicit - vezi prețuri) se aplică pentru fiecare endpoint cu excepția /validate/* și /pdfa/validate, care rămân nemăsurate.
Document tools: 100 cereri/lună pe planul gratuit, până la 50.000/lună pe Ultra - vezi prețuri. Validarea de email în masă e plafonată la 5.000 de adrese / 2 MB per upload.
Server MCP (agenți AI)
Self-hosted, funcționează deja azi cu propria dvs. cheie API - fără așteptare după un endpoint hostat:
{"mcpServers": {"crateapi-einvoicing": {
"command": "python", "args": ["-m", "einvoicing.mcp_server"],
"env": {"EINVOICE_API_KEY": "your-key-here"}}}}
Unelte: validate_invoice (gratuit), repair_invoice, generate_invoice, convert_invoice. Rezumat lizibil de mașină al întregii pagini: /llms.txt · /ai (JSON).