Entregas de webhook - Reenviar

#Visão Geral

Este endpoint reenvia (redeliver) uma entrega específica ao seu endpoint de destino. Diferente do reenvio de evento — que reentrega o evento a todos os endpoints elegíveis —, aqui a reentrega é direcionada ao endpoint exato daquele dispatch, reaproveitando o mesmo registro de entrega. É útil para reprocessar uma falha pontual sem afetar as demais entregas do mesmo evento.

#Descrição

Ao receber o dispatchId, a API localiza o dispatch (junto do evento e do endpoint associados), reconstrói o payload do evento e dispara uma nova tentativa de entrega para aquele endpoint específico. A resposta confirma que o reenvio foi disparado; o recebimento efetivo depende do seu servidor.

#Requisição

POST /v1/webhooks/dispatches/{dispatchId}/redispatch

Cabeçalho: SelectKey: sk_live_... (ou sk_test_...). Escopo necessário: webhooks:update. Não há corpo de requisição.

#Parâmetros de Caminho

#Exemplo de Requisição

POST /v1/webhooks/dispatches/wdi_01hqzvabc/redispatch

#Resposta

#Aceito (202 Accepted)

{
  "accepted": true,
  "id": "wdi_01hqzvabc"
}

#Atributos da Resposta

#Considerações

1. Reentrega direcionada: a reentrega vai apenas ao endpoint daquele dispatch, não a todos os endpoints do evento.

2. Idempotência: garanta que seu endpoint processe o mesmo evento múltiplas vezes sem efeitos colaterais — uma reentrega pode chegar após a entrega original.

3. Confirmação ≠ recebimento: a resposta 202 indica que a reentrega foi disparada; o resultado real aparece em seguida no status/responseStatusCode do dispatch (consulte a listagem).

4. Dispatches legados não são reentregáveis: dispatches sintéticos reconstruídos de eventos legados (ID no formato wdi_legacy_*) não possuem um registro real e retornam 404 ao tentar reentregar.

#Códigos de Erro

#Dispatch não encontrado (404 Not Found)

{
  "error": {
    "status": "Not Found",
    "statusCode": 404,
    "category": "resource",
    "message": "Webhook dispatch not found.",
    "docUrl": "https://docs.api.selectwin.io/errors/resource",
    "supportUrls": [
      "https://suporte.selectwin.io/ajuda"
    ]
  }
}

#Casos de Uso Comuns

1. Recuperação de falha pontual: reentregar um dispatch failed após corrigir uma indisponibilidade temporária do seu servidor.
2. Reprocessamento direcionado: forçar a reentrega a um endpoint específico sem reenviar o evento aos demais.
3. Diagnóstico: confirmar se uma falha é persistente ou transitória observando o resultado da nova tentativa.