Autentisering

Alle endepunkter tar et bearer-token. DynDNS-endepunktet tar i tillegg HTTP Basic Auth.

Bruk API-nøkler for integrasjoner uten tilsyn

For skript og annen tilgang uten tilsyn bruker du en API-nøkkel i stedet for POST /authenticate med passordet ditt. En nøkkel har egne rettigheter, overlever passordbytte og kan trekkes tilbake for seg. Send den på samme måte som et bearer-token.

Bearer-token

POST /authenticate

Felt	Type	Påkrevd	Beskrivelse
username	string	Ja	E-postadressen til kontoen.
password	string	Ja	Passordet til kontoen.
code	number	Hvis 2FA er aktivert	Gjeldende TOTP-kode.

curl -X POST https://api.gigahost.no/api/v0/authenticate \
  -H "Content-Type: application/json" \
  -d '{
    "username": "[email protected]",
    "password": "your-password"
  }'

Respons:

{
  "meta": { "status": 200, "status_message": "200 OK" },
  "data": {
    "token": "<long-bearer-token>",
    "token_expire": 1779843600,
    "customer_id": 12345
  }
}

token_expire er et Unix-tidsstempel.

Bruk tokenet

Send tokenet i Authorization-headeren:

curl https://api.gigahost.no/api/v0/servers \
  -H "Authorization: Bearer $TOKEN"

Ugyldiggjør tokenet

curl -X POST https://api.gigahost.no/api/v0/logout \
  -H "Authorization: Bearer $TOKEN"

HTTP Basic Auth

Godtas bare på GET /dns/dyndns (Dynamic DNS-endepunktet), med e-postadressen og passordet til kontoen. Alle andre endepunkter svarer 401 på Basic Auth. Mislykkede forsøk teller mot samme grense som POST /authenticate (se Grenser for innlogging).

curl -u "[email protected]:your-password" \
  "https://api.gigahost.no/api/v0/dns/dyndns?hostname=home.example.com"

Tofaktorautentisering (2FA)

Med 2FA på må POST /authenticate ha gjeldende TOTP-kode i code:

curl -X POST https://api.gigahost.no/api/v0/authenticate \
  -H "Content-Type: application/json" \
  -d '{
    "username": "[email protected]",
    "password": "your-password",
    "code": 123456
  }'

Uten koden feiler forespørselen med 400 og need2fa: true i meta. Feil kode gir 403 og twofactorfailed: true.

2FA settes opp under Autentisering.

Grenser for innlogging

Mislykkede innlogginger telles per døgn (UTC). Etter 20 feil passord for ett brukernavn fra én IP-adresse, 200 fra én IP-adresse eller 20 feil 2FA-koder for én bruker svarer POST /authenticate med 429 Too many failed login attempts. Please try again later., og HTTP Basic Auth svarer 401 til neste døgn.