Autentificering
Kom i gang

Autentificering

Handelsregister AI API understøtter to autentificeringsmetoder: API-nøgle og Bearer Token. Begge metoder fungerer på alle API-endpoints.

Autentificeringsmetoder

x-api-key: YOUR_API_KEY API-nøgle via Header: Anbefalet til server-til-server integrationer og produktionsbrug
?api_key=YOUR_API_KEY API-nøgle via Query-parameter: Kun til hurtige tests og bagudkompatibilitet
Authorization: Bearer YOUR_TOKEN Bearer Token: Bedst til applikationer, der kræver finjusteret adgangskontrol, token-udløb og forbedret sikkerhed

API-nøgle autentificeringseksempler

Brug af x-api-key Header (Anbefalet)
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 administration

Opret 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 indeholde din Bearer token. Opbevar den sikkert!

Brug af en Bearer Token

curl -X GET "https://handelsregister.ai/api/v1/search-organizations?q=company" \
     -H "Authorization: Bearer YOUR_API_TOKEN"

Token-administrationsendpoints

POST /api/v1/auth/tokens/create Opret ny token
GET /api/v1/auth/tokens Vis alle tokens
DELETE /api/v1/auth/tokens/{id} Tilbagekald specifik token
DELETE /api/v1/auth/tokens Tilbagekald alle tokens