# Webhooks och leveransstatus

Prenumerera på aktuella händelser, verifiera aviseringar och följ leveranser.

## REST-operationer och nyckelbehörigheter

| Uppgift | Nyckelbehörigheter | Börja här |
| --- | --- | --- |
| Registrera webhooks och följ leveranser | `write:webhooks`, `read:webhooks` | `POST /api/v1/landlord/webhooks` |

## Prenumerera på aktuella händelser

Registrera endast händelser från den aktuella katalogen: `application.submitted`, `application.intake_finalized`, `listing.changed`, `listing.unpublished`, `portfolio_import.completed`, `property.created`, `screening.started`, `unit.created`, `rent_roll_import.completed`, `fault_report.created`, `work_order.updated`, `commercial_inspection.created`, `commercial_inspection.updated`, `commercial_inspection.submitted`, `commercial_inspection.reviewed`.

## Verifiera och kvittera notifieringar

Spara signeringshemligheten när webhooken skapas. `X-Homito-Signature` har formatet `sha256=<64 lowercase hexadecimal digits>`. Verifiera HMAC-SHA256 över **anropets råa kroppsbytes**, med hemligheten och en jämförelse i konstant tid. Lagra och deduplicera `X-Homito-Event-Id` beständigt innan du returnerar 2xx. `X-Homito-Delivery` identifierar en leverans; det är inte nyckeln för händelsededuplicering. Leverans sker minst en gång; dubbletter och annan ankomstordning kan förekomma. En notifiering bevisar inte att en senare domänoperation eller ett hyresbeslut har slutförts.

## Läs leveranshälsa separat

Läs leveranshälsa på `GET /api/v1/landlord/webhooks/{webhookId}/deliveries` med `read:webhooks`. Använd ansökningens kvitto/förlopp och auktoriserade ansökningsläsningar för deras separata statuskontroller.

## Bevara ansökningens åtkomsträtter

Versionerad ansökningsinlämning har ett annat kontrakt: bevara dess UUID `X-Application-Submission-Key` samt kvitto- och uppladdningsnycklar. Följ publicerade kvitto-/förloppsoperationer innan du försöker igen. Hyresvärds-API:ts `Idempotency-Key` ersätter inte dessa åtkomsträtter.

## Håll privata uppgifter utanför offentliga cacheminnen

Håll personuppgifter, kvitton och uppladdningsåtkomsträtter utanför offentliga annonscacheminnen. Hyresgäst- och ansökningsläsningar returnerar avsiktligt begränsade operativa projektioner; dra inga slutsatser om utelämnade privata fält eller screeningbedömningar. Skilj null/okända värden från noll eller ett slutfört resultat.