Kom igång

API:t

1. Be om en kod

Svaret är alltid 202, även för en adress som inte har något konto, så att ingen kan pröva sig fram till vilka adresser som finns.

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

2. Byt koden mot en token

Koden står i mejlet och gäller i tio minuter. Svaret har token. Spara den där andra hemligheter bor, inte i koden. Ett nytt konto behöver också name; utan det blir svaret 422 name_required och koden går att skicka igen.

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

3. Se vem du är och vilka hus du har

export TOKEN=hk_live_…
curl "https://husvo.app/api/v1/me" -H "Authorization: Bearer $TOKEN"

Svaret har houses med varje hus id och din roll.

4. Hämta underhållet

curl "https://husvo.app/api/v1/houses/$HOUSE_ID/maintenance" -H "Authorization: Bearer $TOKEN"

Därifrån står allt i referensen. Logga ut tokenen med DELETE /api/v1/auth/token när du är klar med den.

MCP

Skapa en personlig nyckel i husprofilen under Koppla en AI-assistent, eller använd tokenen ovan. Servern har inga sessioner: varje anrop är en egen förfrågan med sin egen token, och Accept ska ta både json och händelseström.

1. Handslaget

curl -X POST "https://husvo.app/mcp" \
  -H "Authorization: Bearer $NYCKEL" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

2. Verktygen

curl -X POST "https://husvo.app/mcp" \
  -H "Authorization: Bearer $NYCKEL" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

3. Ett verktyg

curl -X POST "https://husvo.app/mcp" \
  -H "Authorization: Bearer $NYCKEL" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"lista_hus","arguments":{}}}'

Svaret har husen med houseId och din roll i vart och ett. Hela listan står under MCP och Claude.