Autentisering

Hurtigstart

Hver API-forespørsel krever en Authorization-header med tokenet ditt og en X-Client-System-header som identifiserer applikasjonen din:

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

Hold API-tokenet ditt hemmelig! Behandle det som et passord—aldri sjekk det inn i versjonskontroll eller eksponer det i klient-sidekode.

Slik fungerer autentisering

Fenerum-API-et bruker token-basert autentisering. Inkluder API-tokenet ditt i Authorization-headeren i hver forespørsel med dette formatet:

Authorization: Token <your-token>

Alle forespørsler må gjøres over HTTPS til https://app.fenerum.com/

Skaffe API-tokenet ditt

Opprett et API-token fra Fenerum-organisasjonsinnstillingene:

1. Gå til Settings → Integrations
2. Klikk Create API user i Fenerum-seksjonen

Dette oppretter en API USER med et unikt token. API USER vises i brukerlisten din og har fulle tillatelser som standard—du kan tilpasse disse i brukerprofilen.

Påkrevde headers

Hver API-forespørsel må inkludere disse headerne:

Headeren X-User er særlig verdifull for feilsøking og etterlevelse—den lar deg spore hver API-handling tilbake til en spesifikk bruker i systemet ditt.

Eksempler

Hente data

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

Opprette ressurser

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"
  }'

Fullstendig HTTP-forespørsel

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"
}

Viktige detaljer

Basis-URL

Alle API-endepunkter er relative til:

https://app.fenerum.com/

Avsluttende skråstrek er påkrevd

Alle API-URL-er må ende med en avsluttende skråstrek (/).

Dette er kritisk for POST-, PUT- og PATCH-forespørsler. Selv om GET-forespørsler blir automatisk omdirigert, vil forespørsler med payload feile uten avsluttende skråstrek.

Korrekt:

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

Feil:

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

Teste oppsettet ditt

Bekreft autentiseringen din med en enkel forespørsel:

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

Vellykket respons (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"
    }
  ]
}

Feilrespons (HTTP 401)

{
  "detail": "Invalid token."
}

Feilsøking

Hvis du får autentiseringsfeil, kontroller:

• Manglende Authorization-header — Hver forespørsel må inkludere denne headeren
• Feil token-format — Må være Token <your-token>, ikke bare token-verdien
• Utgått eller tilbakekalt token — Token kan deaktiveres i brukerinnstillinger
• Feil organisasjon — Token er organisasjonsspesifikke og fungerer ikke på tvers av organisasjoner
• Manglende X-Client-System — Denne påkrevde headeren må være med i alle forespørsler

Fortsatt problemer? Kontakt vårt supportteam med detaljer om forespørselen din (uten å inkludere tokenet).