Autentifikácia

Agent API sa autentifikuje API kľúčom v hlavičke X-API-Key. Operácie nad konkrétnou organizáciou navyše vyžadujú X-Organization-Id.

Hlavičky

Hlavička	Povinná	Popis
`X-API-Key`	Áno	Váš partnerský API kľúč (test alebo live).
`X-Organization-Id`	Pri väčšine operácií	UUID klientskej organizácie. Nepovinné pri /v1/agent/organizations a company-lookup.

Typy kľúčov

Prefix	Prostredie	Použitie
`efk_pk_test_…`	Sandbox	Reálna Peppol TEST sieť, žiadne kredity ani účtovanie.
`efk_pk_live_…`	Produkcia	Reálne odoslanie cez Peppol.

Rovnaká base URL https://api.efaktura.sk pre sandbox aj produkciu — prostredie určuje výlučne prefix kľúča (Stripe model). Žiadna samostatná sandbox doména.

Príklad

curl https://api.efaktura.sk/v1/agent/invoices \
  -H "X-API-Key: efk_pk_test_..." \
  -H "X-Organization-Id: <org-uuid>"

Získanie kľúča

Sandbox kľúče si vytvoríte sami v partnerskom portáli v sekcii API kľúče — sú aktívne okamžite. Produkčné (live) kľúče vydáva administrátor po schválení/aktivácii partnera.

Kľúč sa zobrazí iba raz pri vytvorení — bezpečne si ho uložte. Kľúče nikdy nevkladajte do klientskeho kódu ani do verejných repozitárov.