Documentazione

Spec OpenAPI 3.1, esempi di codice e Swagger UI live.

Swagger UI
Esploratore API interattivo
Prova gli endpoint direttamente dal tuo browser. Include il flusso di autenticazione.
OpenAPI 3.1
openapi.json
Spec grezza. Importa in Insomnia, Postman o genera client.
GitHub
SDKs + Action + Fixtures
SDK per Node, Python, Go. GitHub Action. 50 fixture di test.

Endpoint

MetodoPercorsoDescrizione
POST/v1/validateValidazione sincrona. Corpo: XML.
POST/v1/validate/batchBatch asincrono. Restituisce job_id.
GET/v1/jobs/{job_id}Interroga lo stato del batch.
POST/v1/keysCrea chiave API.
DEL/v1/keys/{id}Revoca chiave API.
GET/v1/usageUtilizzo del mese corrente.
GET/v1/healthControllo di disponibilità.

Autenticazione

Tutti gli endpoint (eccetto /v1/health) richiedono una chiave API Bearer:

Authorization: Bearer evk_live_<your-key-here>

Limiti di richieste

Per chiave API per mese solare:

Eccesso: le richieste oltre la tua quota mensile inclusa restituiscono HTTP 429 fino al prossimo reset mensile. Restituisce429 Too Many Requests quando la quota è esaurita.