Webhooks

Receber evento de abertura de porta

Webhook para o parceiro notificar um evento de abertura de porta (acesso). O horário do acesso registrado é o valor de timestamp enviado no payload, não o horário de chegada na Beepay. O endpoint é idempotente por event_id: reenviar um event_id já processado retorna 200 com o mesmo id.

post/api/v1/webhooks/partner-access

Request body

event_idstring uuid required

Identificador único do evento (UUID v4). Usado para idempotência.

device_idstring required

Código do dispositivo (dispositivos.codigo) que registrou o acesso.

user_idinteger required

ID do usuário que realizou o acesso.

timestampstring date-time required

Data/hora em que o acesso ocorreu. Não pode ser uma data futura.

Example request

{
  "event_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
  "device_id": "DEV-001",
  "user_id": 12345,
  "timestamp": "2026-06-17T18:23:24-03:00"
}

Response

Evento já processado (idempotência) — retorna o log existente

idinteger

Example response

{
  "id": 987
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.