Husvo

API-referens

Bilderna

Bilder på rum, poster, prylar och idéer.

Själva bilden

GET /api/v1/photos/{photoId}/content

operationId getPhotoContent

  • Bearer-token

Parametrar

NamnVarTypKrävs
photoId adressen integer ja

Exempel

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

Svar

200 Klart · image/jpeg

Svaret är filen själv.

304 Oförändrad sedan förra hämtningen

Inget innehåll.

Fel, som problem+json (felkoderna):

  • 404Finns inte, eller inte för dig

Radera en bild

DELETE /api/v1/photos/{photoId}

operationId deletePhoto

  • Bearer-token
  • Skrivtaket gäller

Parametrar

NamnVarTypKrävs
photoId adressen integer ja

Exempel

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

Svar

204 Klart, inget innehåll

Inget innehåll.

Fel, som problem+json (felkoderna):

  • 403Inte tillåtet
  • 404Finns inte, eller inte för dig

Ladda upp en jpeg (rå body, högst 8 MB) till ett rum, en loggpost, en pryl eller en idé (högst 20 bilder per idé)

POST /api/v1/houses/{houseId}/photos

operationId uploadPhoto

  • Bearer-token
  • Kräver redigeringsrätt i huset
  • Skrivtaket gäller
  • Tar Idempotency-Key

Parametrar

NamnVarTypKrävs
houseId adressen integer ja
roomId frågesträngen integer nej
logEntryId frågesträngen integer nej
applianceId frågesträngen integer nej
ideaId frågesträngen integer nej

Kropp image/jpeg

Filen skickas som den är, med sin egen innehållstyp.

Exempel

curl -X POST "https://husvo.app/api/v1/houses/1/photos" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: image/jpeg" --data-binary "@bild.jpg"

Svar

201 Skapad · PhotoDto
{
  "id": 1,
  "url": "https://exempel.se/",
  "takenAt": "2026-11-13",
  "roomId": 1,
  "logEntryId": 1,
  "applianceId": 1,
  "isReceipt": false,
  "ideaId": 1,
  "isCover": false
}

Fel, som problem+json (felkoderna):

  • 403Inte tillåtet
  • 404Finns inte, eller inte för dig
  • 413För stort
  • 422Kontrollera uppgifterna
Sidan hakade upp sig.Ladda om🗙