Skip to main content
POST
Consultez avec pagination la consommation de minutes de traduction et de synchronisation labiale ainsi que l’historique des débits et remboursements, avec des filtres facultatifs par date, langue, statut et projet.

​
Authentification et autorisations

​
string
requis
Envoyez une clé API VoiceCheap dans cet en-tête. Authorization: Bearer avec la même clé API est également accepté. Les jetons d’accès OAuth sont acceptés uniquement par MCP, pas par cet endpoint REST.
Autorisations requises: usage:read. Un abonnement payant actif est requis. Les autorisations ne modifient ni les rôles dans l’équipe, ni la propriété des ressources, ni les crédits média, ni les limites du forfait.

​
Paramètres

​
string
Valeur textuelle.Valeurs acceptées: “translation”, “project”. Valeur par défaut: “translation”.
​
string
Valeur textuelle.Longueur minimale: 1. Longueur maximale: 200. Motif: ^[^/]+$.
​
string
Valeur textuelle.Longueur minimale: 1. Longueur maximale: 200.
​
string
Valeur textuelle.Longueur minimale: 2. Longueur maximale: 64.
​
string
Valeur textuelle.Valeurs acceptées: “all”, “none”, “standard”, “pro”, “pro_2”.
​
array
Liste de valeurs. Consultez le schéma d’entrée complet pour connaître la structure de ses éléments.Nombre maximal d’éléments: 4.
​
string
Valeur textuelle.Valeurs acceptées: “all”, “charged”, “refunded”, “refund_pending”.
​
string
Valeur textuelle.Format: “date”. Motif: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$.
​
string
Valeur textuelle.Format: “date”. Motif: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$.
​
integer
Nombre entier.Minimum: 1. Maximum: 100000. Valeur par défaut: 1.
​
integer
Nombre entier.Minimum: 1. Maximum: 100. Valeur par défaut: 25.
Le JSON Schema ci-dessous conserve les noms de champs exacts, les types imbriqués, les valeurs par défaut, les limites et les valeurs acceptées exposés par la découverte. Les règles supplémentaires entre champs figurent dans les notes de l’opération.

​
Exemples de requêtes

Remplacez les exemples d’identifiants de ressources et de clés média par des valeurs renvoyées pour votre compte. Conservez le même identifiant de requête lorsque vous réessayez la même mutation.

​
Réponse

Une première exécution réussie renvoie HTTP 200 avec le résultat de l’opération sous data. Une nouvelle tentative peut renvoyer à la place l’état de la requête enregistrée. L’exemple présente une réponse possible, sans tous les champs facultatifs. Renvoie les lignes paginées d’utilisation des traductions ou des projets, les filtres normalisés et les totaux de minutes de toutes les lignes correspondantes.

​
Champs du résultat

​
Notes de l’opération

  • view vaut translation par défaut, page vaut 1 et pageSize vaut 25 ; pageSize ne peut pas dépasser 100.
  • Les filtres de date utilisent YYYY-MM-DD et comparent la date de début de traduction dans le fuseau Europe/Paris. fromDate ne peut pas être postérieur à toDate.
  • project recherche dans les noms et les ID de projets sans tenir compte de la casse. translatedVersionId recherche une sous-chaîne dans les ID de versions en vue traduction et est ignoré en vue projet.
  • Les totaux couvrent toutes les lignes de traduction correspondantes, avant pagination. La vue projet regroupe ces lignes par projet.
  • Les lignes publiques omettent les adresses e-mail des utilisateurs à l’origine des actions et les messages d’erreur de traitement bruts.

​
Utilisation

Chaque invocation réussie consomme un appel du quota mensuel API/MCP. Les crédits média et les quotas de génération propres à l’opération s’appliquent également.

​
Erreurs