Integracao

[ESPEC] Pessoa cadastrada no espaco (enviado por nos)

Especificacao — ainda nao implementado. Este endpoint esta publicado para acordo de contrato; chamadas retornam 404 ate a implementacao.

Nos chamamos voce. Disparado quando alguem conclui um cadastro no espaco — tipicamente um visitante que usou um link gerado por POST /visitor-links, mas tambem cadastros feitos na recepcao ou pelo formulario publico.

Serve para o sistema de origem espelhar o registro e, quando for o caso, atribuir a essa pessoa uma identidade propria via POST /persons. Enquanto ela nao tiver identity.externalId, os eventos de acesso dela ficam retidos e nao sao entregues no webhook access-event.

Mesmas garantias de entrega, assinatura e resposta esperada do webhook access-event.

postWebhook/person-registered

Headers

X-Preddita-Event-Idstring uuid required

Identificador unico da entrega. Use como chave de idempotencia.

X-Preddita-Signaturestring required

HMAC-SHA256 do corpo bruto, no formato sha256=<hex>, calculado com o segredo do webhook. Valide antes de processar.

Example:sha256=9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08

X-Preddita-Delivery-Attemptstring required

Numero da tentativa de entrega, comecando em 1.

Example:1

Payload

PersonRegisteredEvent required(unresolved $ref)

Response

Evento recebido. Qualquer 2xx confirma a entrega.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.