Webhooks och leveransstatus
På den här sidan
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.