Login og nøgler
ownr API bruger OAuth 2.0 med client credentials: du bytter din nøgle til et access token og sender tokenet med i hvert kald.
API-nøgler
En nøgle består af et Client ID og et Client secret. Der er to slags:
| Nøgle | Hvem opretter den | Bruges til |
|---|---|---|
| Personlig nøgle | Hver bruger, under API Adgang | Egne scripts og AI-assistenter |
| Integrationsnøgle | En administrator, samme sted | Systemer som CRM og ERP |
- En nøgle følger licensen hos den bruger, der ejer den.
- Alle nøgler i virksomheden deler samme kvote.
- En integrationsnøgle hører ikke til en medarbejder, så den virker stadig, hvis en medarbejder stopper.
Hent et access token
curl -X POST https://ownr.dk/api/v2/token \ -d grant_type=client_credentials \ -d client_id=CLIENT_ID \ -d client_secret=CLIENT_SECRET{ "status": "success", "access_token": "…", "expires_in": 3600, "token_type": "Bearer", "scope": "companies persons properties ajour pipeline"}- Tokenet gælder i
expires_insekunder (3.600). Hent et nyt, når det udløber. - Du kan også sende Client ID og Client secret som HTTP Basic-login i stedet for i kroppen.
Brug tokenet
Send tokenet i Authorization-headeren:
curl https://ownr.dk/api/v2/company/36732261 \ -H "Authorization: Bearer ACCESS_TOKEN"Scopes
En nøgle får automatisk disse fem scopes: companies, persons, properties, ajour og pipeline. Øvrige scopes tildeles af ownr. Et endpoint svarer 403, hvis tokenet mangler dets scope.
| Scope | Endpoints |
|---|---|
companies |
/company/… (også /company/segments), /p-unit/…, /report/…, /account/followed/companies |
persons |
/person/… (også /person/segments), /account/followed/persons |
properties |
/property/… (også /property/segments), /account/followed/properties |
ajour |
/company/{cvr}/ajour, /person/{itemId}/ajour, /property/{dafId}/ajour, /account/ajour/… |
pipeline |
/pipelines… |
companies, persons eller properties |
/segments/downloads… |
companies eller persons |
/beneficial-owners/purposes |
Reelle ejere
Opslag på reelle ejere kræver en særskilt godkendelse, uanset licens. Uden den står der Access required i feltet for reelle ejere, og resten af svaret er uændret.