GET
/api/v1/houses/{houseId}/share-links
operationId listShareLinks
- Bearer-token
- Kräver läsrätt i huset
Parametrar
| Namn | Var | Typ | Krävs |
|---|
houseId |
adressen |
integer |
ja |
Exempel
curl -X GET "https://husvo.app/api/v1/houses/1/share-links" \
-H "Authorization: Bearer $TOKEN"
Svar
200 Klart · ShareLinkListResponse
{
"items": [
{
"id": 1,
"createdAt": "2026-11-13T08:00:00Z",
"validUntil": "2026-11-13T08:00:00Z",
"createdBy": "text",
"ideaIds": [
1
],
"ideaTitles": [
"text"
],
"includePhotos": false,
"replies": 1
}
]
}
Fel, som problem+json (felkoderna):
- 404Finns inte, eller inte för dig
POST
/api/v1/houses/{houseId}/share-links
operationId createShareLink
- Bearer-token
- Kräver redigeringsrätt i huset
- Skrivtaket gäller
Parametrar
| Namn | Var | Typ | Krävs |
|---|
houseId |
adressen |
integer |
ja |
Kropp application/json · ShareLinkBody
| Fält | Typ | Krävs |
|---|
ideaIds |
integer[] |
nej |
includePhotos |
boolean |
nej |
{
"ideaIds": [
1
],
"includePhotos": false
}
Exempel
curl -X POST "https://husvo.app/api/v1/houses/1/share-links" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"ideaIds":[1],"includePhotos":false}'
Svar
201 Skapad · ShareLinkCreatedDto
{
"id": 1,
"url": "https://exempel.se/",
"validUntil": "2026-11-13T08:00:00Z"
}
Fel, som problem+json (felkoderna):
- 403Inte tillåtet
- 422Kontrollera uppgifterna
DELETE
/api/v1/houses/{houseId}/share-links/{linkId}
operationId revokeShareLink
- Bearer-token
- Kräver redigeringsrätt i huset
- Skrivtaket gäller
Parametrar
| Namn | Var | Typ | Krävs |
|---|
houseId |
adressen |
integer |
ja |
linkId |
adressen |
integer |
ja |
Exempel
curl -X DELETE "https://husvo.app/api/v1/houses/1/share-links/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