Skip to main content
GET
Agrégation de facturation
GET https://api-datahub.octoparse.com/v1/billing Authentification : clé API requise (Authorization: Bearer <API Key>). Combien vous avez dépensé sur une période, et où. Indépendant de l’endpoint d’identité du compte. La plage de temps utilise le même vocabulaire que List runs : created_from / created_to sont des horodatages absolus ISO-8601, inclus/exclus, basés sur l’heure de début de l’exécution. Passez les mêmes bornes à List runs pour examiner en détail les exécutions derrière le total de n’importe quel groupe. tz_offset détermine seulement le jour local auquel une exécution est rattachée dans les regroupements par jour ; il ne modifie ni les montants ni la plage absolue elle-même. Seuls les frais de données sont agrégés. Les groupes par jour sont triés par ordre croissant pour le rapprochement ; les groupes par app et par identifiant sont triés par montant décroissant, pour afficher d’abord les dépenses les plus élevées. La ventilation par credential répond à la question « combien chacune de mes clés a-t-elle dépensé ? ». La clé est un id d’identifiant stable et non sensible, la même valeur que celle utilisée par le filtre credential de List runs. Le périmètre est toujours votre compte ; vous ne voyez jamais les identifiants d’une autre personne.

Requête

Paramètres de requête

string
défaut:"day"
Dimension de ventilation : day (par défaut), data_app ou credential.
string
Début inclus. Omettez-le pour partir de la plus ancienne exécution.
string
Fin exclue. Omettez-la pour inclure jusqu’à maintenant.
integer
défaut:"0"
Décalage horaire des regroupements par jour, en minutes par rapport à UTC. Utilisez 480 pour l’heure normale de Chine ; la valeur par défaut 0 correspond aux jours UTC. Décalage fixe uniquement (pas d’heure d’été). Les created_from / created_to des requêtes de détail doivent utiliser le même décalage. Plage de -720 à 840.

Exemple de requête

Réponse

200 succès

La charge utile est encapsulée dans data. Champs :
number
Total de la période ; égal à la somme des valeurs amount des groupes.
string
Devise.
string
Dimension effectivement utilisée.
object[]
Lignes de groupe. Tous les champs de dimension sont présents ; ceux qui ne sont pas utilisés valent null.

Erreurs

Les réponses d’erreur utilisent {"error": {code, category, message, retryable}}. Voir Erreurs.

Bibliothèques clientes