API pro organizaci

Načtěte metadata organizace daného přístupového klíče. Na veřejném API jen pro čtení — nastavení organizace (retence, souhlas se SMS, KYB) se spravuje z administrátorské plochy v aplikaci, kde auditní řetězec zaznamenává, kdo co změnil + kdy.

Získání organizace

GET /api/v1/public/org — oprávnění org:read

curl https://app.nexbasira.com/api/v1/public/org \
  -H "Authorization: Bearer nb_sec_..."

{
  "id": "00000000-0000-0000-0000-000000000000",
  "name": "Acme Insurance",
  "country": "FR",
  "settings_jsonb": {
    "default_locale": "fr",
    "auto_record_sessions": false
  },
  "retention_days": 2555,
  "sms_enabled": true,
  "created_at": "2024-09-01T08:00:00Z"
}

Pole	Typ	Poznámky
`id`	UUID	Stabilní po celou dobu životnosti přístupového klíče.
`name`	string	Zobrazovaný název. Zobrazuje se v pozvánkových e-mailech + v záhlaví PDF reportu.
`country`	ISO 3166-1 alpha-2	Určuje výchozí locale + jurisdikci KYB.
`settings_jsonb`	object	Volně strukturované předvolby na úrovni organizace (výchozí locale, přepínač automatického nahrávání atd.). Schéma je dopředně kompatibilní — s neznámými klíči zacházejte jako s informativními.
`retention_days`	int \| null	Jak dlouho se bajty důkazů uchovávají v objektovém úložišti, než je pravidla životního cyklu vymažou. `null` = výchozí hodnota platformy (7 let pro nasazení kompatibilní s eIDAS).
`sms_enabled`	bool	Zda je povoleno doručování pozvánek přes SMS. Výchozí hodnota je false; přihlaste se přes administrátorskou kartu SMS.
`created_at`	ISO 8601	Časové razítko vytvoření organizace.

Běžné chyby

Stav	Kód	Kdy
403	`permission_denied`	Přístupový klíč nemá `org:read`.

Poznámky

Jedna organizace na přístupový klíč. Každý přístupový klíč veřejného API je vázán přesně na jednu organizaci; nepředáváte org_id — přístupový klíč jej vyřeší na straně serveru.
Žádné rozhraní pro zápis. Změny nastavení organizace probíhají přes administrátorské UI, aby bylo možné auditovat identitu operátora + důvod. Veřejné API zde záměrně zůstává jen pro čtení.
White-label. Pro přizpůsobení loga + barev viz API pro branding — to je zapisovatelná část.