Reenviar uma entrega

Enfileira de novo uma entrega que já saiu. O corpo e a assinatura são recalculados com o segredo vigente do endpoint.

POSThttps://api.navenaut.com/webhooks-out/endpoints/{endpointId}/deliveries/{outboxId}/resend

Autenticação

A sessão do painel autentica esta rota, e ela é lida de forma autoritativa: não há parâmetro em que o chamador aponte para outra conta.

Esta rota não exige escopo nomeado — o que não quer dizer que ela seja aberta: sem a credencial acima ela recusa.

Exige sessão de vendedor. Todo endpoint lido ou escrito é escopado pela sessão: o identificador na URL nunca alcança o endpoint de outro vendedor.

Nome	Tipo	Descrição
`endpointId`obrigatório	texto	O identificador do endpoint, como ele aparece na listagem.
`outboxId`obrigatório	texto	O identificador da entrega, como ele aparece no histórico.

Nome	Tipo	Descrição
`idempotency-key`obrigatório	texto	A chave que torna o reenvio seguro. O MESMO valor devolve o MESMO reenvio, em vez de despachar dois.

{
  "replayed": true,
  "status": "queued"
}

O header idempotency-key não veio, ou começa por um início que a Naut reserva; nada foi enfileirado.

A entrega não existe, não é sua, ou não é uma entrega automática deste endpoint. Reenvio de reenvio não existe: reenvie sempre a entrega original.

A mesma chave de idempotência já foi usada com um corpo diferente.

Status	Código	Quando	O que fazer
400	`IDEMPOTENCY_KEY_RESERVED`	O cabeçalho `idempotency-key` começa por um início que a Naut reserva para as próprias chaves (`checkout-plan:`, `subscription-attempt:`, `renewal:`, `reward-claim:` ou `kyc-identity-correction:`). A recusa vem antes de qualquer escrita: nada foi enfileirado, e nenhuma entrega saiu.	Reenvie com outra chave, que não comece por nenhum desses inícios. Um UUID por reenvio serve.
400	`IDEMPOTENCY_KEY_REQUIRED`	A chamada chegou sem o cabeçalho `idempotency-key`, ou com ele em branco. A recusa vem antes de qualquer escrita: nada foi enfileirado, e nenhuma entrega saiu.	Gere um valor por reenvio, envie no cabeçalho e reenvie a chamada. Repetir sem a chave devolve sempre o mesmo 400.
404	`WEBHOOK_DELIVERY_NOT_FOUND`	A entrega não existe, não é sua, ou não é uma entrega automática deste endpoint. Reenvio de reenvio não existe: só a entrega original pode ser reenviada, e é ela que carrega o evento.	Ache a entrega original no histórico do endpoint e use o identificador dela. Repetir com o mesmo identificador não muda o resultado.
409	`IDEMPOTENCY_FINGERPRINT_MISMATCH`	Esta chave já foi usada para reenviar outra entrega. É o que impede uma chave reaproveitada de despachar um reenvio que você não pediu.	Gere uma chave nova para este reenvio. Para repetir o reenvio anterior, use a chave dele com a mesma entrega: a resposta volta igual, sem despachar de novo.

Os códigos são estáveis e fazem parte do contrato. A lista completa, com todos os vocabulários, está na tabela de erros.