ConverterHQDevelopers
API v1

Checklist de produção

Controles antes de receber tráfego real de clientes.

Trate o lançamento como promoção controlada: credenciais live separadas, upload direto verificado, retries idempotentes, webhooks assinados e observabilidade pronta.

Credenciais e escopos

Use chave live do projeto certo com escopo mínimo, salve no secret manager e verifique GET /v1/me no smoke test.

Arquivos e capabilities

Teste upload S3 direto a partir do ambiente real, incluindo CORS no navegador quando aplicável. Verifique capability e settings da dupla antes de enviar.

Confiabilidade

Adicione Idempotency-Key, backoff com jitter, timeouts, webhooks verificados e deduplicação. Teste falha de engine, 429, timeout e retry de webhook.

Operação e rollout

Prepare alertas, dashboard de uso, status page e rollback. Comece com uma fração do tráfego, compare sucesso/latência/custo e aumente aos poucos.