ConverterHQDevelopers
API v1

Checklist production

Contrôles à terminer avant d’envoyer du trafic client réel.

Traitez la mise en production comme une promotion contrôlée: identifiants live séparés, transfert direct vérifié, retries idempotents, webhooks signés et observabilité prête avant le premier pic.

Identifiants et scopes

Utilisez une clé live liée au bon projet avec le minimum de scopes. Stockez-la dans votre gestionnaire de secrets et vérifiez GET /v1/me au démarrage ou pendant le smoke test.

Fichiers et capacités

Testez l’upload direct S3 depuis votre environnement réel, y compris CORS navigateur si nécessaire. Vérifiez la capability exacte et les settings avant de soumettre une paire.

Fiabilité

Ajoutez Idempotency-Key, backoff avec jitter, timeouts clients, webhooks vérifiés et logique de déduplication. Exercez échec moteur, 429, timeout et webhook en retry.

Exploitation et lancement

Configurez alertes, tableau d’usage, status page et rollback. Commencez par une fraction du trafic, comparez succès/latence/coût puis augmentez progressivement.