Vérifier une requête et ses limites
Confirmez l’URL de base, l’endpoint, l’authentification, les champs obligatoires, la réponse et l’unité de facturation du service. Chaque API de la place de marché peut avoir son propre contrat ; ne supposez pas qu’elle utilise l’endpoint ou le format de la passerelle IA. Consultez le guide d’abonnement et de test en ligne. Gardez les identifiants sur le serveur, dans un gestionnaire de secrets ou la configuration d’environnement. Séparez développement et production, masquez les en-têtes d’autorisation dans les journaux et conservez une requête fonctionnelle expurgée avec les champs de réponse indispensables à votre application.Fixer un délai et un budget de reprises
Définissez les délais de connexion, de lecture et de l’opération complète. Un flux de réponses nécessite aussi un délai d’inactivité. Choisissez-les selon vos mesures et l’attente acceptable pour l’utilisateur. Pour une opération courte, vous pourriez expérimenter avec 5 secondes de connexion, 30 secondes au total et deux reprises au maximum. Ce sont des paramètres d’exemple, pas les valeurs par défaut de Rock API.
Utilisez une attente exponentielle avec une variation aléatoire et respectez
Retry-After lorsqu’il est fourni. Limitez le nombre total de tentatives et leur durée. Vérifiez ensemble les reprises du SDK, du proxy et des tâches pour éviter leur multiplication.
Traiter les résultats incertains
Une expiration ne prouve pas que le serveur a rejeté l’opération. Répéter un POST peut créer une seconde ressource, une nouvelle génération ou une autre dépense. Utilisez une clé d’idempotence uniquement si l’endpoint documente sa prise en charge, sa portée et sa durée de conservation. Un en-tête arbitraire n’apporte aucune garantie. Sinon, gardez un identifiant local d’opération et rapprochez le résultat d’un endpoint de statut documenté ou d’un relevé d’usage avant de répéter une action sensible. Testez les fragments, les déconnexions, l’annulation et les marqueurs de fin des flux. Relancer une génération partiellement reçue peut produire un contenu différent et une consommation supplémentaire.Tester les quotas et déployer progressivement
Utilisez une file bornée et un plafond de concurrence par service. Distinguez débit, tokens, caractères et quotas quotidiens ou mensuels. Surveillez quota et solde ; chaque429 ne justifie pas un forfait supérieur.
Dans un environnement sûr, testez les identifiants invalides, les entrées malformées, l’épuisement du quota, les réponses lentes, les flux interrompus et les doublons. Commencez par un petit déploiement avec des critères de retour arrière. Enregistrez identifiant, statut, durée, reprises et usage finalement facturé sans conserver les contenus privés. Vérifiez coût et latence P95 avant d’augmenter le trafic.
Examiner la sécurité et la confidentialité
Évaluez le parcours des données, la conservation, les secrets et le traitement des incidents avant la production.