Dezvoltatori

Un API de extragere pregătit pentru producție.

Încarcă fișiere, interoghează starea, primește webhookuri semnate și citește câmpuri normalizate cu ID-uri de cerere, idempotență, tokenuri de test și contract OpenAPI.

Obține acces la API Documentație API

Ciclul API

Proiectat pentru reîncercări, procesare asincronă și context clar pentru asistență.

Încărcările sunt asincrone și idempotente. Documentele finalizate returnează câmpuri, iar cele blocate sau eșuate returnează context utilizabil.

Încărcare

curl -X POST "https://www.exdata.app/api/v1/documents" \
  -H "Authorization: Bearer $EXDATA_API_TOKEN" \
  -H "Idempotency-Key: invoice-upload-001" \
  -F "file=@invoice.pdf" \
  -F "locale=en" \
  -F "custom_types[]=invoice"

Rezultat

{
  "status": "completed",
  "mode": "live",
  "is_e_invoice": true,
  "extractions": {
    "type": {
      "value": "invoice",
      "candidates": ["invoice"]
    },
    "document_number": {
      "value": "RE-2026-1048",
      "candidates": ["RE-2026-1048"]
    },
    "sender_name": {
      "value": "Meyer Supply GmbH",
      "candidates": ["Meyer Supply"]
    },
    "recipient_name": {
      "value": "Northwind Operations Ltd.",
      "candidates": ["Northwind Operations"]
    },
    "payment_due_date": {
      "value": "2026-06-14",
      "candidates": ["14.06.2026"]
    },
    "net_amount": {
      "value": "1079.50",
      "candidates": ["1,079.50"]
    },
    "tax_breakdowns": {
      "value": [
        {
          "taxable_amount": "1079.50",
          "tax_amount": "205.10",
          "tax_rate": "19.00",
          "tax_collection_mechanism": "seller_collected"
        }
      ],
      "candidates": ["VAT 19% 205.10"]
    },
    "gross_amount": {
      "value": "1284.60",
      "candidates": ["EUR 1,284.60"]
    },
    "currency": {
      "value": "EUR",
      "candidates": ["EUR"]
    },
    "iban": {
      "value": "DE89370400440532013000",
      "candidates": ["DE89 3704 0044 0532 0130 00"]
    }
  },
  "latest_extraction_run": {
    "extraction_schema_version": "2026-08-28.1",
    "normalization_version": "base:2026-10-21.3"
  }
}

Parcurs de integrare

Dezvoltă și testează integrarea înainte de a consuma credite de producție.

Creează un token de test

Tokenurile de test folosesc aceleași endpointuri, validare, idempotență, webhookuri și erori ca tokenurile live.

Încarcă fișiere reprezentative

Folosește PDF-uri reprezentative, etichete proprii și limba potrivită pentru fiecare document. Cheile de idempotență împiedică încărcările repetate să creeze duplicate.

Treci la tokenuri live

Treci după ce interogarea, webhookurile, erorile și maparea ulterioară au fost testate în siguranță.

După lansare

Detaliile integrării sunt vizibile când contează.

Când un document eșuează, este blocat sau produce un rezultat neașteptat, integrarea are context citibil automat și o cale clară în spațiul de lucru.

ID-uri de cerere: Fiecare răspuns API conține un ID prin care asistența poate lega o sesizare de cererea exactă.
Antete webhook semnate: Livrările includ antete pentru eveniment, livrare, marcă temporală și semnătură, necesare verificării.
Erori citibile automat: Erorile includ mesaj, cod și ID de cerere pentru gestionarea clară a reîncercărilor și asistenței.
Contract OpenAPI: Contractul API v1 este publicat și validat pentru ca SDK-urile, integrările și documentația să rămână aliniate.
Limite și backoff: Limitele per token și cont protejează serviciul și oferă un model clar de reîncercare.

Documentație

Începe cu ghidul rapid, apoi conectează interogarea sau webhookurile.

Documentație API OpenAPI YAML