Hubday
Developer Portal

Idempotência

Mutações de Appointment exigem uma chave estável de 8 a 255 caracteres.

Atualizado em 01/09/2026
POST /v1/appointments
Idempotency-Key: crm-appointment-98217
  • A chave deve ter entre 8 e 255 caracteres.
  • A Hubday persiste o resultado por 24 horas para replay da mesma operação lógica.
  • Mesma chave + mesmo método/path/body reproduz o resultado persistido.
  • Replay bem-sucedido inclui Idempotent-Replayed: true.
  • Mesma chave + request diferente retorna 409 IDEMPOTENCY_KEY_REUSED.
  • Se a requisição ainda estiver processando, 409 IDEMPOTENCY_REQUEST_IN_PROGRESS inclui Retry-After.
Importante: Quando houver timeout ou perda de conexão após enviar uma mutação, não gere uma segunda chave. Repita exatamente a mesma chamada com a chave original até obter o resultado autoritativo.