> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hubfy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Idempotência

> Repita uma operação sem criar registros duplicados.

Todo `POST` aceita o cabeçalho `Idempotency-Key`. Use uma chave diferente para cada operação lógica e reutilize a mesma chave quando repetir essa operação após uma falha de rede.

A Hubfy associa a chave à conta, ao método, ao caminho e aos parâmetros. Uma chamada concluída devolve o mesmo corpo e status nas repetições. Cada tentativa HTTP recebe seu próprio `X-Request-Id`.

## Regras

* Use de 1 a 255 caracteres ASCII imprimíveis, sem espaços.
* Não reutilize a chave para outra rota ou outros parâmetros: isso retorna `400`.
* Uma operação ainda em andamento pode retornar `409`; aguarde antes de repetir.
* O resultado permanece disponível por pelo menos 24 horas. Depois da remoção do registro, a mesma chave pode iniciar outra operação.
* Falhas de validação antes do início da operação não reservam um resultado.

Repetir a criação de upload devolve a mesma credencial temporária; isso não renova sua validade. Para iniciar outro envio depois que ela expirar, use outra operação e outra chave.

Sem `Idempotency-Key`, dois POSTs de criação podem criar dois registros.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.