Nastavenia

Vývojári

API a integrácie

Externé služby (hostingový panel, registrátor, vlastné skripty) sa pýtajú fakturácie na platnosť predplatného, stav faktúr a zostatok kreditov cez REST API. Webhooky sú len upozornenie – zdrojom pravdy je vždy API.

Dokumentácia API

Základná URL

/api/v1/integration

Autentifikačná hlavička

Authorization: Bearer ak_…

Každá požiadavka na /api/v1/integration sa overuje API kľúčom v hlavičke Authorization ako Bearer token. Kľúč vidíte iba raz pri vytvorení; čo smie robiť, určujú jeho oprávnenia.

curl -H "Authorization: Bearer ak_xxxxxxxx…" \
  /api/v1/integration/subscriptions

Úplný zoznam koncových bodov, schémy odpovedí a formát webhookov nájdete v dokumentácii API (OpenAPI 3.1).

API kľúče

Kľúče pre externé služby. Každý kľúč má vlastné oprávnenia a voliteľnú expiráciu; zrušený kľúč prestane fungovať okamžite.

Webhooky

Upozornenia na udalosti (uhradená faktúra, nová objednávka, obnovené predplatné) na vaše URL. Doručenie je best-effort s opakovaním; stav si vždy overte cez API.

Provisioning služieb

Endpointy, na ktoré fakturácia posiela udalosti o objednávkach, predplatnom a kreditoch – hostingový panel, licenčný server alebo vlastná služba podľa nich zriaďuje a ruší služby. Doručenie sa opakuje s narastajúcim odstupom; po vyčerpaní pokusov ostane udalosť v zozname na ručné doručenie.

Nastavenie prijímača

Adresa, na ktorú hostingový panel posiela udalosti o službách, a tajomstvo, ktorým ich podpisuje.

Prichádzajúce udalosti

Čo nám poslali externé služby: hostingový panel hlási zriadenie, pozastavenie a zrušenie služby. Podpis sa overuje z presného tela požiadavky a každá udalosť sa spracuje najviac raz.