ConverterHQDevelopers
API v1

Checklist di produzione

Controlli prima di inviare vero traffico cliente.

Tratta il go-live come una promozione controllata: credenziali live separate, upload diretto verificato, retry idempotenti, webhook firmati e osservabilità pronta.

Credenziali e scope

Usa una live key del progetto corretto con scope minimi, salvala nel secret manager e verifica GET /v1/me nello smoke test.

File e capabilities

Prova l’upload diretto S3 dall’ambiente reale, incluso CORS browser se necessario. Verifica capability e settings esatti prima dell’invio.

Affidabilità

Aggiungi Idempotency-Key, backoff+jitter, timeout, webhook verificati e deduplica. Esercita errore motore, 429, timeout e webhook retry.

Operazioni e rollout

Prepara alert, usage dashboard, status page e rollback. Inizia con una quota di traffico, confronta successo/latenza/costo e aumenta gradualmente.