Verejný sandbox15 minútEnterprise API

15-minútový ERP Test Lab

Jeden riadený postup pre integrátora: získa JWT, overí demo Peppol participantov, spustí preflight, odošle sandbox doklad, overí webhook podpis a stiahne evidence bundle.

Spustiť labDemo účty v docs
Sandbox prihlasovacie údaje

Verejné demo údaje sú použiteľné v snippete aj v runneri.

Demo integrátor
8924a11d-a93c-4d5a-b54b-1f1ff246152c
sk_int_t...87c282
Test odosielateľ
0245:0000000001
f2cea3cf-f29e-4ea2-9e76-b06a312ec9ab
Test prijímateľ
0245:0000000002
b1022d80-5016-4dad-a8d2-53685cab1701
Sprievodca integráciou

Flow ako Swagger, ale zložený podľa reálneho ERP scenára

Swagger ukáže endpointy. Tento lab ukazuje poradie volaní, hlavičky, demo firmu a čo má ERP vyhodnotiť po každom kroku.

Scenár testu

Happy path

Všetky kroky idú cez živý sandbox proxy.

Priebeh integrácie
Stav, HTTP a trvanie každého kroku v jednom behu.
Exporty integrácie

Completion report, Postman a sandbox config

Po behu labu si integrátor odnesie testovací dôkaz, Postman collection, OpenAPI sandbox a .env export pre ERP.

Uložené behy

História test labu

localStorage

Po spustení celého labu tu ostane krátka história behov pre implementátora.

Sandbox JWT
POST /api/v1/auth/token
token chýbadocumentId zatiaľ nie
kopírovateľná ukážka volania
curl -s -X POST https://epostak.sk/api/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "client_credentials",
    "client_id": "8924a11d-a93c-4d5a-b54b-1f1ff246152c",
    "client_secret": "sk_int_t...87c282"
  }'

# export TOKEN="<access_token from response>"
Odpoveď labu
Spustite prvý krok. Odpoveď API sa zobrazí tu.
Checklist pred produkciou

Čo musí ERP vedieť pred produkciou

Lab je len prvý smoke test. Pred živým klientom musí integrátor dokázať, že vie bezpečne rotovať tokeny, deduplikovať send, overovať webhooky a uložiť dôkazový balík.

  • JWT získaný cez client_credentials
  • X-Firm-Id posielané pri integrátorskom kľúči
  • Preflight číta decision, canSend a errors[]
  • Send používa Idempotency-Key
  • Webhook podpis overený cez HMAC-SHA256
  • Evidence bundle uložený v ERP audit traili

Technická dokumentácia

Presné parametre, response schémy, error kódy a demo účty ostávajú v Enterprise docs.

Enterprise docs

SAPI vs Enterprise

Rozdiel medzi štandardným rozhraním a rozšíreným Enterprise API ostáva na samostatnej stránke.

API integrácia

Produkčný prístup

Produkčné kľúče negenerujeme verejne. Pre partnerov ich vydávame po aktivácii integrátora.

Kontakt