Skip to main content

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​

NomeTipoObrigatórioDescrição
idnumber✅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
}