Authentication

Hurtig start

Hver API-forespørgsel kræver en Authorization-header med dit token og en X-Client-System-header, der identificerer din applikation:

curl https://app.fenerum.com/api/v1/accounts/ \
  -H "Authorization: Token your-token-here" \
  -H "X-Client-System: YourAppName"

Hold dit API-token hemmeligt! Behandl det som en adgangskode—commit det aldrig til versionsstyring, og eksponér det ikke i client-side kode.

Sådan fungerer autentificering

Fenerum API’et bruger token-baseret autentificering. Inkludér dit API-token i Authorization-headeren for hver forespørgsel i dette format:

Authorization: Token <your-token>

Alle forespørgsler skal foretages over HTTPS til https://app.fenerum.com/

Sådan får du dit API-token

Opret et API-token i dine Fenerum organisationsindstillinger:

1. Gå til Settings → Integrations
2. Klik på Create API user i Fenerum-sektionen

Dette opretter en API USER med et unikt token. API USER’en vises i din brugerliste og har som udgangspunkt fulde rettigheder—disse kan tilpasses i brugerprofilen.

Påkrævede headers

Hver API-forespørgsel skal inkludere disse headers:

Headeren X-User er særligt værdifuld til fejlfinding og compliance—den lader dig spore enhver API-handling tilbage til en specifik bruger i dit system.

Eksempler

Hentning af data

curl https://app.fenerum.com/api/v1/accounts/ \
  -H "Authorization: Token abc123def456" \
  -H "X-Client-System: MyAwesomeCRM" \
  -H "X-User: john.doe"

Oprettelse af ressourcer

curl -X POST https://app.fenerum.com/api/v1/accounts/ \
  -H "Authorization: Token abc123def456" \
  -H "X-Client-System: MyAwesomeCRM" \
  -H "X-User: john.doe" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "CUST001",
    "name": "Acme Corporation",
    "email": "contact@acme.com"
  }'

Komplet HTTP-anmodning

POST /api/v1/accounts/ HTTP/1.1
Host: app.fenerum.com
Authorization: Token abc123def456
X-Client-System: MyAwesomeCRM
X-User: john.doe
Content-Type: application/json

{
  "code": "CUST001",
  "name": "Acme Corporation",
  "email": "contact@acme.com"
}

Vigtige detaljer

Basis-URL

Alle API-endpoints er relative til:

https://app.fenerum.com/

Afsluttende skråstreg påkrævet

Alle API-URL'er skal slutte med en afsluttende skråstreg (/).

Dette er kritisk for POST-, PUT- og PATCH-forespørgsler. GET-forespørgsler vil automatisk omdirigere, men forespørgsler med payload vil fejle uden den afsluttende skråstreg.

Korrekt:

/api/v1/accounts/
/api/v1/accounts/123/

Forkert:

/api/v1/accounts
/api/v1/accounts/123

Test af din opsætning

Verificér din autentificering med en simpel forespørgsel:

curl https://app.fenerum.com/api/v1/accounts/ \
  -H "Authorization: Token your-token-here" \
  -H "X-Client-System: TestClient"

Succesrespons (HTTP 200)

{
  "count": 10,
  "next": "https://app.fenerum.com/api/v1/accounts/?page=2",
  "previous": null,
  "results": [
    {
      "uuid": "123e4567-e89b-12d3-a456-426614174000",
      "code": "CUST001",
      "name": "Acme Corporation",
      "email": "contact@acme.com"
    }
  ]
}

Fejlrespons (HTTP 401)

{
  "detail": "Invalid token."
}

Fejlfinding

Hvis du modtager autentificeringsfejl, så kontroller:

• Manglende Authorization-header — hver forespørgsel skal inkludere denne header
• Forkert tokenformat — skal være Token <your-token>, ikke kun selve tokenværdien
• Udløbet eller tilbagekaldt token — tokens kan deaktiveres i brugerindstillinger
• Forkert organisation — tokens er organisationsspecifikke og virker ikke på tværs af organisationer
• Manglende X-Client-System — denne påkrævede header skal være til stede på alle forespørgsler

Har du stadig problemer? Kontakt vores supportteam med detaljer om din forespørgsel (uden at medtage dit token).