Skip to main content
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.