Obtenez des statistiques d’utilisation API détaillées grâce à la fonctionnalité d’affichage des caractères facturés de DeepL
Points essentiels
- Les utilisateurs de l’API de DeepL peuvent obtenir des rapports sur le nombre de caractères facturés pour chaque requête API réussie.
- Le paramètre « show_billed_characters » permet aux utilisateurs d’accéder immédiatement aux données d’utilisation de l’API, directement dans la réponse API.
- Ces données d’utilisation par requête peuvent être utilisées dans des rapports personnalisés et des processus de suivi des coûts directement depuis l’API.
- Elles sont particulièrement utiles pour les contenus structurés tels que le HTML ou le XML, où les caractères traduisibles peuvent être plus difficiles à identifier.
- Cette fonctionnalité étend les rapports de l’API de DeepL au-delà de l’endpoint /usage et vous aide à surveiller l’activité de traduction avec une plus grande précision.
- Le nouveau paramètre « show_billed_characters » est déjà disponible pour tous les clients de l’API de DeepL sans configuration supplémentaire.
L’API de DeepL a toujours accordé la priorité aux rapports et à l’analyse pour les développeurs et les professionnels comme vous. Cela vaut aussi bien via l’endpoint /usage directement dans l’API elle-même que via la fonctionnalité de reporting pour clés d’API multiples.
Notre équipe a ajouté cette fonctionnalité pratique à notre liste croissante d’outils de reporting : « show_billed_characters » est désormais disponible pour tous les clients de l’API.
Elle vient compléter les fonctionnalités de reporting en constante évolution de l’API de DeepL et permet désormais d’obtenir une vue détaillée du nombre de caractères facturés dans les données de réponse de chaque requête API.
Qu’est-ce que le paramètre « show_billed_characters » ?
Jusqu’à présent, la seule façon pour les utilisateurs de l’API d’obtenir des données d’utilisation précises directement depuis l’API DeepL consistait à appeler l’endpoint /usage. Il s’agit d’un moyen efficace de récupérer les informations concernant l’utilisation de caractères les plus récentes pour la période de facturation en cours. Cependant, elle ne fournit pas de ventilation précise des caractères traduits dans chaque requête.
Un paramètre optionnel résout ce problème en renvoyant le nombre de caractères traduits et facturés avec la réponse de chaque requête API réussie.
Découvrez des études flexibles au niveau des clés pour les utilisateurs de l’API de DeepL.
Comment fonctionne le paramètre « show_billed_characters » ?
Les clients de l’API qui effectuent des requêtes directement auprès de l’API, par exemple via une commande cURL, peuvent ajouter le nouveau paramètre « show_billed_characters » à leurs requêtes. De cette façon, le nombre de caractères facturés apparaît dans les données de réponse.
Les réponses API impliquant un coût par caractère renverront alors une nouvelle valeur entière au format « billed_characters:50 » à chaque réponse.
Vous pouvez suivre cette valeur du côté de l’utilisateur de l’API afin de l’utiliser dans les workflows de reporting et de suivre le coût de chaque requête API individuelle.
Ceci est particulièrement important pour les requêtes contenant du contenu structuré comme du HTML ou du XML, où il peut être difficile d’identifier les caractères traduisibles.
À l’avenir, l’équipe DeepL prévoit d’inclure « billed_characters » par défaut dans la réponse de l’API de DeepL. À ce moment-là, il sera nécessaire de définir « show_billed_characters » sur « false » pour ne pas inclure « billed_characters » dans la réponse de l’API.
Découvrez comment DeepL renforce la sécurité grâce à des clés d'API multiples.
À quoi ressemble la réponse de l’API avec « show_billed_characters »
Actuellement, vous obtenez une réponse similaire à celle-ci lorsque vous envoyez une requête à l’API :
Votre réponse ressemblera à ceci si vous envoyez une requête en utilisant le nouveau paramètre « show_billed_characters » :
Pourquoi DeepL a ajouté le rapport sur les caractères facturés par requête
De nombreux clients ont demandé cet outil. Il vous permet de générer des rapports de facturation par caractère de manière détaillée et d’intégrer ces données directement dans vos propres outils de reporting à chaque requête de traduction API réussie.
Le paramètre « show_billed_characters » est pleinement opérationnel au sein de l’API de DeepL pour les utilisateurs de DeepL. Aucune configuration supplémentaire n’est requise.
De plus, notre documentation API a été mise à jour pour refléter ce changement et faciliter la tâche aux développeurs, comme vous, qui souhaitent intégrer cette fonctionnalité à vos processus et commencer à bénéficier d’une plus grande précision de traduction.
Pour plus d’informations, consultez les descriptions du corps de la requête et les notes de mise à jour.
Créez des rapports plus intelligents grâce à l'API de DeepL