# Ping (https://docs.pulsarml.com/pt/v1/api-reference/webhooks/ping)

Enviado quando o Pulsar testa o seu endpoint. Pode chegar a um endpoint independentemente do tipo de evento para que está registado, por isso responda `2XX` em vez de rejeitar os tipos de evento que não esperava.

## Webhook: `Ping`

Pulsar sends a `POST` request with this body to the HTTPS endpoint you registered for the `Ping` event. Verify `X-Pulsar-Signature` before trusting it; see https://docs.pulsarml.com/webhooks/signatures.

### Header parameters

- `X-Pulsar-Signature` (string, required, e.g. `"5c0e2f4a1b9d8e7f6a5b4c3d2e1f0a9b8c7d6e5f4a3b2c1d0e9f8a7b6c5d4e3f"`) — Assinatura HMAC-SHA256 do corpo em bruto. Verifique-a antes de confiar no pedido; consulte Verificar assinaturas.
- `X-Pulsar-Event-Type` (string, required, e.g. `"Ping"`) — O tipo de evento, igual a `eventType` no corpo.
- `X-Pulsar-Event-Id` (string, required, e.g. `"8d2f6c1e-4b7a-4f0e-9a3c-5e1d7b9f2a64"`) — O ID do evento, igual a `eventId` no corpo.
- `X-Pulsar-Timestamp` (string, required, e.g. `"2026-09-25T14:03:12.482Z"`) — Igual a `eventTimestamp` no corpo.
- `X-Pulsar-Request-Id` (string, required, e.g. `"3f9b2c7d-1e4a-4c8b-b6d2-9a0e5f7c1b38"`) — O ID desta tentativa de entrega. Inclua-o quando contactar o suporte do Pulsar sobre uma entrega.

### Request body (`application/json`, required)

Type: object

- `eventId` (string (uuid), required) — ID único do evento. Não muda entre novas tentativas, por isso use-o para detetar duplicados.
- `eventTimestamp` (string (date-time), required) — Quando o Pulsar colocou o evento em fila, como data e hora UTC em ISO 8601. Não é o momento em que a alteração ocorreu no Pulsar.
- `eventType` ("Ping", required) — O tipo de evento.
- `event` (object, required)
  - `text` ("ping", required) — Sempre `ping`.

### Your response

#### 200 — Responda com qualquer `2XX` em menos de 10 segundos para confirmar a entrega; o Pulsar ignora o corpo da resposta. Um tempo limite esgotado, `408`, `429` ou `5XX` dá origem a uma nova tentativa. Qualquer outro `4XX`, ou um redirecionamento `3XX`, não.

### Example body

```json
{
  "eventId": "0b6f3d2a-9c1e-4a7b-8f5d-2e4c6a8b0d1f",
  "eventTimestamp": "2026-09-25T14:00:00.000Z",
  "eventType": "Ping",
  "event": {
    "text": "ping"
  }
}
```