API

Przegląd

Desta udostępnia REST API pozwalające na integrację z zewnętrznymi systemami. API jest dostępne w planach Profesjonalny i wyżej.

Autoryzacja

API wykorzystuje tokeny Bearer. Token generujesz w Ustawienia → API → Nowy token.

Authorization: Bearer dst_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Endpointy

Faktury

GET    /api/v1/invoices              Lista faktur
GET    /api/v1/invoices/{id}          Szczegóły faktury
POST   /api/v1/invoices               Utwórz fakturę
PUT    /api/v1/invoices/{id}          Edytuj fakturę
DELETE /api/v1/invoices/{id}          Usuń fakturę (draft)
POST   /api/v1/invoices/{id}/finalize Finalizuj fakturę
GET    /api/v1/invoices/{id}/pdf      Pobierz PDF

Kontrahenci

GET    /api/v1/contractors            Lista kontrahentów
GET    /api/v1/contractors/{id}       Szczegóły
POST   /api/v1/contractors            Utwórz
PUT    /api/v1/contractors/{id}       Edytuj
GET    /api/v1/contractors/nip/{nip}  Wyszukaj po NIP (GUS)

KSeF

GET    /api/v1/ksef/invoices          Faktury pobrane z KSeF
POST   /api/v1/ksef/send/{id}        Wyślij fakturę do KSeF
GET    /api/v1/ksef/upo/{id}         Pobierz UPO
GET    /api/v1/ksef/status            Status sesji KSeF

JPK

POST   /api/v1/jpk/generate           Wygeneruj JPK_V7M
GET    /api/v1/jpk/{id}              Pobierz plik JPK
GET    /api/v1/jpk/validate/{id}     Walidacja JPK

Format odpowiedzi

Wszystkie odpowiedzi w formacie JSON. Paginacja przez parametry page i per_page.

{
  "data": [...],
  "meta": {
    "current_page": 1,
    "per_page": 25,
    "total": 142
  }
}

Webhook-i

Desta może wysyłać webhook-i HTTP POST na podany URL przy zdarzeniach:

• invoice.created — nowa faktura
• invoice.finalized — faktura sfinalizowana
• ksef.sent — faktura wysłana do KSeF
• ksef.received — nowa faktura pobrana z KSeF
• settlement.confirmed — klient potwierdził kompletność dokumentów

Rate limiting

API limitowane do 100 requestów/minutę per token. Header X-RateLimit-Remaining informuje o pozostałym limicie.