Compte et facturation
Agrégation de facturation
Somme les dépenses d’une période et les découpe par jour, app ou credential.
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
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.