Gå til indhold

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

Terminal window
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_in sekunder (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:

Terminal window
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.