Dla programistów

API do ekstrakcji gotowe do pracy w produkcji.

Przesyłaj pliki, sprawdzaj statusy, odbieraj podpisane webhooki i odczytuj znormalizowane pola. Korzystaj z identyfikatorów żądań, idempotencji, tokenów testowych i specyfikacji OpenAPI.

Uzyskaj dostęp do API Dokumentacja API

Cykl API

Ponawianie, przetwarzanie asynchroniczne i dane ułatwiające pomoc techniczną.

Przesyłanie jest asynchroniczne i idempotentne. Ukończone dokumenty zwracają pola, a zablokowane lub błędne — kontekst do dalszej obsługi.

Przesyłanie

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"

Wynik

{
  "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"
  }
}

Ścieżka integracji

Sprawdź działanie integracji przed wykorzystaniem kredytów produkcyjnych.

Utwórz token testowy

Tokeny testowe używają tych samych endpointów, walidacji, idempotencji, webhooków i błędów co tokeny produkcyjne.

Prześlij reprezentatywne pliki

Użyj reprezentatywnych PDF-ów, własnych etykiet i języka odpowiadającego każdemu dokumentowi. Klucze idempotencji zapobiegają tworzeniu duplikatów przy ponownym przesyłaniu.

Przejdź na tokeny produkcyjne

Przełącz się po bezpiecznym sprawdzeniu odpytywania, webhooków, błędów i mapowania do systemów docelowych.

Po uruchomieniu

Szczegóły integracji są widoczne, gdy są potrzebne.

Gdy przetwarzanie kończy się błędem, dokument zostaje zablokowany lub wynik różni się od oczekiwań, integracja otrzymuje dane do dalszej obsługi, a zespół może sprawdzić szczegóły w przestrzeni roboczej.

Identyfikatory żądań: Każda odpowiedź API zawiera identyfikator, dzięki któremu pomoc może powiązać zgłoszenie z dokładnym żądaniem.
Podpisane nagłówki webhooków: Dostarczenia zawierają nagłówki zdarzenia, dostarczenia, znacznika czasu i podpisu, dzięki którym odbiorca może zweryfikować webhook.
Błędy czytelne maszynowo: Błędy zawierają komunikat, kod i identyfikator żądania, które ułatwiają ponawianie i obsługę zgłoszeń pomocy technicznej.
Specyfikacja OpenAPI: Specyfikacja API v1 jest opublikowana i walidowana, aby SDK, integracje i dokumentacja pozostawały spójne.
Limity żądań i odstępy między ponowieniami: Limity tokenów i kont chronią usługę, dając integracjom jasny model ponawiania.

Dokumentacja

Zacznij od szybkiego startu, a następnie podłącz odpytywanie lub webhooki.

Dokumentacja API OpenAPI YAML