Skip to main content
Replay an Event Delivery V2
Use este endpoint para reenviar uma entrega ao seu endpoint de webhook. O SpherePay faz exatamente uma tentativa automática por evento e por endpoint, e nunca tenta novamente por conta própria, portanto recuperar uma entrega que falhou enquanto seu endpoint estava fora do ar é uma chamada deliberada a este endpoint. O caminho recebe o ID da entrega, não o ID do evento. Encontre-o no objeto delivery retornado por listar eventos ou no histórico completo de obter evento, ou leia-o do header Sphere-Delivery-Id da requisição original. Um replay reenvia o payload idêntico byte a byte com um Sphere-Timestamp e um Sphere-Signature novos, mais os headers Sphere-Delivery-Type: replay e Sphere-Replay-Reason: manual. Seu caminho de código de verificação é o mesmo para originais e replays. Um replay bem-sucedido move a entrega para delivered; um com falha a deixa em failed e registra outra tentativa. O histórico de tentativas é preservado em qualquer caso.
Replays são entregues pelo menos uma vez em cima do que seu endpoint já recebeu, e uma entrega que já teve êxito pode ser reenviada. Deduplique pelo id do evento e aplique a verificação de obsolescência de sequence para que um replay seja sempre seguro de receber.

Autorizações

Authorization
string
header
obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parâmetros de caminho

eventDeliveryId
string
obrigatório

Resposta

The replay is queued for delivery. No content is returned; poll the event to observe the new attempt.

Última modificação em 27 de agosto de 2026