Inloggning

Mejlad kod in, enhetstoken ut. Och utloggning av den egna enheten.

DELETE/api/v1/auth/token Logga ut den här enheten
POST/api/v1/auth/token Byt koden mot en enhetstoken
POST/api/v1/auth/code Be om en inloggningskod till en mejladress

Logga ut den här enheten

DELETE /api/v1/auth/token

operationId logOut

Bearer-token
Skrivtaket gäller

Exempel

curl -X DELETE "https://husvo.app/api/v1/auth/token" \
  -H "Authorization: Bearer $TOKEN"

Svar

204 Klart, inget innehåll

Inget innehåll.

Fel, som problem+json (felkoderna):

401Inte inloggad

Byt koden mot en enhetstoken

POST /api/v1/auth/token

operationId redeemCode

Ingen inloggning
Skrivtaket gäller

Kropp application/json · RedeemBody

Fält	Typ	Krävs
`email`	string	nej
`code`	string	nej
`name`	string	nej
`device`	DeviceBody	nej

{
  "email": "du@exempel.se",
  "code": "text",
  "name": "text",
  "device": {
    "name": "text",
    "platform": "text",
    "appVersion": "text",
    "pushToken": "text"
  }
}

Exempel

curl -X POST "https://husvo.app/api/v1/auth/token" \
  -H "Content-Type: application/json" \
  -d '{"email":"du@exempel.se","code":"text","name":"text","device":{"name":"text","platform":"text","appVersion":"text","pushToken":"text"}}'

Svar

200 Klart · TokenResponse

{
  "token": "hk_live_…",
  "expiresAt": "2026-11-13T08:00:00Z",
  "user": {
    "id": 1,
    "name": "text",
    "email": "du@exempel.se"
  },
  "device": {
    "id": 1,
    "name": "text",
    "platform": "text",
    "appVersion": "text",
    "createdAt": "2026-11-13T08:00:00Z",
    "lastUsedAt": "2026-11-13T08:00:00Z",
    "current": false
  }
}

Fel, som problem+json (felkoderna):

403Inte tillåtet
422Kontrollera uppgifterna
429För många anrop

Be om en inloggningskod till en mejladress

POST /api/v1/auth/code

operationId requestCode

Ingen inloggning
Skrivtaket gäller

Kropp application/json · RequestCodeBody

Fält	Typ	Krävs
`email`	string	nej

{
  "email": "du@exempel.se"
}

Exempel

curl -X POST "https://husvo.app/api/v1/auth/code" \
  -H "Content-Type: application/json" \
  -d '{"email":"du@exempel.se"}'

Svar

202 Mottagen

Inget innehåll.

Fel, som problem+json (felkoderna):

422Kontrollera uppgifterna
429För många anrop