Passer au contenu principal
Agrège par date et par API le nombre de requêtes et le montant réellement déduit pour le compte actuel, adapté à la création de rapports mensuels, de graphiques de tendances et d’analyses de coûts. Pour le débogage entrée par entrée, utilisez la liste des enregistrements d’appels ; pour les détails hors ligne complets, utilisez l’export du volume d’appels. La période de consultation des enregistrements d’appels et des résumés de facturation couvre les 60 derniers jours ; les corps des requêtes et des réponses sont conservés séparément pendant les 30 derniers jours. L’expiration des corps ne modifie pas les frais réels, l’utilisation ou les statistiques agrégées de cet enregistrement.

Préparatifs

  1. Connectez-vous à la plateforme AceDataCloud.
  2. Créez un jeton de compte dans la console Account Token, puis enregistrez-le immédiatement.
  3. Pour restreindre le périmètre, obtenez les ID correspondants depuis la liste des demandes de service, la liste des identifiants API ou la liste des API.
Pour une description complète des jetons, consultez Gérer les jetons de compte. Cette interface utilise un Account Token et n’utilise pas de Credential métier.

Aperçu de l’interface

Paramètres de requête

start_time / end_time peuvent toujours être utilisés comme alias de compatibilité pour les anciens clients ; les nouvelles intégrations utilisent uniformément created_at_from / created_at_to. La forme date de created_at_to inclut ce jour civil, c’est-à-dire que minuit du jour suivant est utilisé comme limite.

Exemples de requêtes

Interroger l’agrégation quotidienne/API du mois en cours à l’heure de Pékin, avec la dimension de modèle :
Interroger l’utilisation d’une semaine pour une Application spécifiée :
Exemple Python :

Exemple de réponse

Champs de réponse

L’unité de crédit dépend de service.unit de l’Application associée. Si la requête inclut des services ayant des unités différentes, effectuez d’abord des statistiques séparées par service_id ou application_id, afin d’éviter les comparaisons ou additions directes. Lorsque l’heure de fin n’est pas supérieure à l’heure de début, l’interface renvoie une structure vide complète : items=[], total=0, apis={}, requests=0, models=[].

Erreurs et recommandations de performance

  • N’activez pas include_models par défaut ; activez-le uniquement lorsque le rapport nécessite réellement une répartition par modèle.
  • Pour les requêtes à grande échelle, séparez en priorité par service_id ou application_id, afin d’éviter de mélanger les unités et de réduire le coût de la requête.
  • Les dates sans appels ne sont pas automatiquement complétées avec zéro ; le client doit compléter l’axe des dates avant le traçage du graphique.

Étapes suivantes