Autentisering
Handelsregister AI API støtter to autentiseringsmetoder: API-nøkkel og Bearer Token. Begge metoder fungerer på alle API-endepunkter.
Autentiseringsmetoder
x-api-key: YOUR_API_KEY |
API-nøkkel via Header: Anbefalt for server-til-server integrasjoner og produksjonsbruk |
?api_key=YOUR_API_KEY |
API-nøkkel via Query-parameter: Kun for raske tester og bakoverkompatibilitet |
Authorization: Bearer YOUR_TOKEN |
Bearer Token: Best for applikasjoner som krever finkornet tilgangskontroll, token-utløp og forbedret sikkerhet |
API-nøkkel autentiseringseksempler
curl -X GET "https://handelsregister.ai/api/v1/search-organizations?q=company" \
-H "x-api-key: YOUR_API_KEY"
# Using query parameter (legacy)
curl "https://handelsregister.ai/api/v1/fetch-organization?api_key=YOUR_API_KEY&q=company"
# Using x-api-key header (recommended)
curl -X GET "https://handelsregister.ai/api/v1/fetch-organization?q=company" \
-H "x-api-key: YOUR_API_KEY"
Bearer Token administrasjon
Opprett en API-token
curl -X POST "https://handelsregister.ai/api/v1/auth/tokens/create" \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"token_name": "My Application",
"abilities": ["*"],
"expires_at": "2026-01-01 00:00:00"
}'
Svaret vil inneholde din Bearer token. Oppbevar den sikkert!
Bruk av en Bearer Token
curl -X GET "https://handelsregister.ai/api/v1/search-organizations?q=company" \
-H "Authorization: Bearer YOUR_API_TOKEN"
Token-administrasjonsendepunkter
POST /api/v1/auth/tokens/create |
Opprett ny token |
GET /api/v1/auth/tokens |
List alle tokens |
DELETE /api/v1/auth/tokens/{id} |
Tilbakekall spesifikk token |
DELETE /api/v1/auth/tokens |
Tilbakekall alle tokens |