POST Enviar Ping de Teste
Envia um evento técnico webhook.ping ao endpoint, para testar a URL e a verificação de assinatura sem depender de eventos reais. É sempre entregue, independentemente de event_types e filters. O envio é assíncrono: use o event_id devolvido em Listar Entregas (event_id=) para ver o resultado.
Autenticação necessária
Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.
Permissão necessária
Exige a permissão manage_webhooks.
Endpoint
POST https://api-dev.imagemais.com.br/api/webhooks/endpoints/{id}/ping
Parâmetros de Rota
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | number | ✅ | ID do endpoint de webhook |
Requisição
curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/webhooks/endpoints/1/ping' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}'
Respostas
202 Aceito
{
"event_id": "evt_01M4E8BB44BXNGF09XM1FAB8Z9"
}
403 Sem permissão
{
"message": "Permissões insuficientes",
"error": "Forbidden",
"statusCode": 403
}
404 Não encontrado
{
"message": "Endpoint de webhook não encontrado",
"error": "Not Found",
"statusCode": 404
}
422 Regra de negócio
{
"message": "Endpoint desativado: habilite antes de testar",
"error": "Unprocessable Entity",
"statusCode": 422
}