Org-API
Läs uppgiftens organisationsmetadata. Skrivskyddad i det publika API:t — organisationsinställningar (lagring, SMS-opt-in, KYB) hanteras från admin-ytan i appen där revisionskedjan fångar vem som ändrade vad + när.
Hämta organisationen
GET /api/v1/public/org — scope 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"
} | Fält | Typ | Noteringar |
|---|---|---|
id | UUID | Stabil under uppgiftens livstid. |
name | string | Visningsnamn. Visas i inbjudningsmejl + PDF-rapportens sidhuvud. |
country | ISO 3166-1 alpha-2 | Styr standardlokal + KYB-jurisdiktion. |
settings_jsonb | object | Fria inställningar på organisationsnivå (standardlokal, auto-inspelningsväxel osv.). Schemat är framåtkompatibelt — behandla okända nycklar som informativa. |
retention_days | int | null | Hur länge Evidence-bytes behålls i objektlagring innan lifecycle-regler rensar dem. null = plattformens standard (7 år för eIDAS-kompatibla driftsättningar). |
sms_enabled | bool | Om SMS-leverans av inbjudningar är aktiverad. Standard är false; opt-in via admin-SMS-kortet. |
created_at | ISO 8601 | Tidsstämpel för organisationens skapande. |
Vanliga fel
| Status | Kod | När |
|---|---|---|
| 403 | permission_denied | Uppgiften saknar org:read. |
Noteringar
- En organisation per uppgift. Varje publik-API-uppgift är begränsad till exakt en organisation; du skickar inte något
org_id— uppgiften löser upp det på serversidan. - Ingen skrivyta. Ändringar av organisationsinställningar går via admin-UI:t så att operatörens identitet + skäl kan revideras. Det publika API:t förblir skrivskyddat här med avsikt.
- White-label. För anpassning av logotyp + färg, se Branding-API — det är det skrivbara hörnet.