Org API
Læs legitimationens organisationsmetadata. Skrivebeskyttet på det offentlige API — organisationsindstillinger (opbevaring, SMS-tilvalg, KYB) håndteres fra admin-fladen i appen, hvor audit-kæden fanger, hvem der ændrede hvad + hvornår.
Hent 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"
} | Felt | Type | Noter |
|---|---|---|
id | UUID | Stabil i hele legitimationens levetid. |
name | string | Visningsnavn. Vises i invitations-e-mails + PDF-rapportens sidehoved. |
country | ISO 3166-1 alpha-2 | Styrer standard-locale + KYB-jurisdiktion. |
settings_jsonb | object | Fritekst-præferencer på organisationsniveau (standard-locale, til/fra for automatisk optagelse osv.). Skemaet er fremadkompatibelt — behandl ukendte nøgler som informative. |
retention_days | int | null | Hvor længe bevis-bytes opbevares i object storage, før lifecycle-regler renser dem. null = platformens standard (7 år for eIDAS-konforme deployments). |
sms_enabled | bool | Om levering af SMS-invitationer er aktiveret. Er som standard false; tilvælges via admin-SMS-kortet. |
created_at | ISO 8601 | Tidsstempel for organisationens oprettelse. |
Almindelige fejl
| Status | Kode | Hvornår |
|---|---|---|
| 403 | permission_denied | Legitimationen mangler org:read. |
Noter
- Én organisation pr. legitimation. Hver legitimation til det offentlige API er scopet til præcis én organisation; du sender ikke et
org_id— legitimationen resolver det på serversiden. - Ingen skriveflade. Ændringer af organisationsindstillinger går gennem admin-UI'en, så operatørens identitet + begrundelse kan revideres. Det offentlige API forbliver bevidst skrivebeskyttet her.
- White-label. For tilpasning af logo + farver, se Branding API — det er det skrivbare hjørne.