Webhook · enviado pelo Cuidaro

Ping de teste

EVENTO ping

Enviado só quando você chama POST /webhook-endpoints/{endpoint}/ping, só para esse endpoint. Não precisa (nem pode) ser assinado em events.

Cabeçalhos

Cuidaro-Signature string · cabeçalho obrigatório

t=<unix>,v1=<hex> — v1 = HMAC-SHA256 com o segredo do endpoint sobre "<t>.<corpo bruto>" (esquema do Stripe). Compare em tempo constante e recuse t com mais de 300 s de diferença.

Cuidaro-Event-Id string · cabeçalho obrigatório

Igual a id do corpo; não muda entre tentativas nem no reenvio. Use para deduplicar.

Cuidaro-Event-Type string · cabeçalho obrigatório

Igual a type do corpo.

User-Agent string · cabeçalho obrigatório

Valores: Cuidaro-Webhooks/1.0

Corpo

id string obrigatório

evt_ + ULID em minúsculas. Chave de deduplicação: igual ao cabeçalho Cuidaro-Event-Id.

api_version string obrigatório

Valores: 2026-10-26

schema_version string obrigatório

Valores: 1

type string obrigatório

Valores: ping

created_at string obrigatório

UTC, sufixo Z.

formato date-time

data object obrigatório

Conteúdo específico do evento (ver webhooks).

webhook_endpoint_id integer obrigatório

message string obrigatório

Veja como verificar a assinatura e como responder, deduplicar e lidar com retentativas.

Exemplo do corpo

{
  "id": "evt_exemplo01",
  "api_version": "2026-10-26",
  "schema_version": "1",
  "type": "ping",
  "created_at": "2026-10-27T11:00:00-03:00",
  "data": {
    "webhook_endpoint_id": 42,
    "message": "texto"
  }
}