Husvo

API-referens

Husets år

Årssammanställningen, som json och pdf.

Husets år: avklarade uppgifter, förbättringsutgifter, mest aktiva rum och prylar, garantier och Husses replik

GET /api/v1/houses/{houseId}/year/{year}

operationId getYearInReview

  • Bearer-token
  • Kräver läsrätt i huset

Parametrar

NamnVarTypKrävs
houseId adressen integer ja
year adressen integer ja

Exempel

curl -X GET "https://husvo.app/api/v1/houses/1/year/1" \
  -H "Authorization: Bearer $TOKEN"

Svar

200 Klart · YearReviewResponse
{
  "year": 2026,
  "isCurrent": false,
  "years": [
    1
  ],
  "tasksDone": 1,
  "distinctTasks": 1,
  "renovationsDone": 1,
  "late": 1,
  "lateTasks": [
    "text"
  ],
  "neverDone": 1,
  "neverTasks": [
    "text"
  ],
  "improvementTotalKr": 1,
  "improvementMissingCost": 1,
  "improvementMissingReceipt": 1,
  "improvements": [
    {
      "logId": 1,
      "date": "2026-11-13",
      "what": "text",
      "costKr": 1,
      "hasReceipt": false
    }
  ],
  "rooms": [
    {
      "name": "text",
      "count": 1
    }
  ],
  "appliances": [
    {
      "name": "text",
      "count": 1
    }
  ],
  "warranties": [
    {
      "name": "text",
      "until": "2026-11-13",
      "daysLeft": 1
    }
  ],
  "mood": "text",
  "husseLine": "text"
}

Fel, som problem+json (felkoderna):

  • 404Finns inte, eller inte för dig

Husets år som pdf

GET /api/v1/houses/{houseId}/year/{year}/pdf

operationId exportYearInReview

  • Bearer-token
  • Kräver läsrätt i huset
  • Skrivtaket gäller

Parametrar

NamnVarTypKrävs
houseId adressen integer ja
year adressen integer ja

Exempel

curl -X GET "https://husvo.app/api/v1/houses/1/year/1/pdf" \
  -H "Authorization: Bearer $TOKEN"

Svar

200 Klart · application/pdf

Svaret är filen själv.

Fel, som problem+json (felkoderna):

  • 404Finns inte, eller inte för dig
Sidan hakade upp sig.Ladda om🗙