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áš API kľúč (test alebo live): z aplikácie alebo partnerský.
`X-Organization-Id`	Pri väčšine operácií	UUID klientskej organizácie. Nepovinné pri /v1/agent/organizations a company-lookup.

Typy kľúčov

Prefix	Vlastník	Prostredie
`efk_test_…`	Firma (kľúč z aplikácie)	Sandbox: reálna Peppol TEST sieť, žiadne kredity ani účtovanie.
`efk_live_…`	Firma (kľúč z aplikácie)	Produkcia: reálne odoslanie cez Peppol.
`efk_pk_test_…`	Partner	Sandbox: reálna Peppol TEST sieť, žiadne kredity ani účtovanie.
`efk_pk_live_…`	Partner	Produkcia: reálne odoslanie cez Peppol; vie spravovať klientske organizácie.

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

Firma s vlastným systémom: test aj live kľúč si vytvoríte sami v aplikácii (fa.efaktura.sk → Nastavenia → API kľúče), aktívne okamžite, bez schvaľovania. Partner: sandbox kľúč si vytvoríte sami v partnerskom portáli v sekcii API kľúče; produkčný (live) partnerský kľúč vydáva administrátor po schválení/aktivácii partnera. Neviete, ktorá cesta je vaša? Pozrite Prístup a účty.

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.