Consommation d’ACU

Cette documentation concerne les déploiements fédéraux de Devin. Retour à la documentation Devin

Consultez la consommation d’ACU en envoyant une requête typée à l’endpoint Analytics. La réponse peut inclure un total pour l’ensemble de la Team, des totaux pour un maximum de 100 groupes sélectionnés et des lignes paginées par utilisateur pour l’ensemble de la Team ou pour un groupe.

POST https://<your-server>/api/v1/Analytics

Nécessite l’autorisation Analytics Read et un niveau Team donnant accès à l’API d’analyse. Consultez la vue d’ensemble de l’API pour plus d’informations sur l’authentification, la pagination et les erreurs, ainsi que les limites d’ACU pour comprendre le lien entre la consommation et l’application des règles.

Une requête peut contenir soit la requête typée acu_consumption_query décrite ici, soit l’ancienne requête personnalisée query_requests, mais pas les deux.

Requête

string

requis

Votre clé de service disposant de l’autorisation Analytics Read.

string

Début d’une période historique au format RFC 3339 (par exemple 2025-01-01T00:00:00Z). Obligatoire pour les requêtes historical ; doit être omis pour les requêtes current_cycle.

string

Fin d’une période historique au format RFC 3339. La période est inclusive et ne peut pas dépasser 90 jours.

object

requis

Requête typée de consommation d’ACU.

Afficher Objet de requête de consommation d’ACU

object

Interroge une période historique définie par les champs start_timestamp et end_timestamp de premier niveau. Transmettez un objet vide : "historical": {}. Un seul des champs historical ou current_cycle est obligatoire.

object

Interroge l’utilisation en quasi temps réel pour le cycle de facturation en cours. Transmettez un objet vide : "current_cycle": {}. Les horodatages de premier niveau doivent être omis.

boolean

Inclut le total d’ACU de toute la Team. Non disponible pour les clés limitées à un groupe.

array

Jusqu’à 100 ID de groupes à inclure comme totaux par groupe. Les groupes inconnus, appartenant à une autre Team ou hors périmètre renvoient not_found. Une clé de service limitée à un groupe ne peut demander que le groupe qui lui est attribué.

object

Demande des lignes d’ACU par utilisateur pour un périmètre donné.

Afficher Objet de périmètre utilisateur

object

Lignes par utilisateur pour l’ensemble de la Team. Transmettez un objet vide : "team": {}. Non disponible pour les clés limitées à un groupe.

string

Lignes par utilisateur pour un groupe. Le groupe doit également figurer dans group_ids.

integer

Lignes d’utilisateurs par page, de 1 à 1 000. La valeur par défaut est 100.

string

Jeton issu du champ next_page_token d’une réponse précédente. Tous les autres champs de la requête doivent rester inchangés.

Réponse

object

Afficher Résultat de la consommation d’ACU

object

Résultats pour l’ensemble de la Team. total_acus est présent lorsque include_team_total a été défini ; user_rows est renseigné lorsque user_scope.team a été demandé.

array

Une entrée par groupe demandé : group_id, group_name, total_acus et user_rows (renseigné pour le groupe sélectionné dans user_scope.group_id).

string

Présent lorsqu’il existe d’autres lignes utilisateur. Valide pendant 24 heures.

object

period_start, period_end, generated_at, team_id, les group_ids demandés et le billing_mode de la Team.

Chaque ligne utilisateur contient :

Champ	Description
`user_id`	ID utilisateur stable et non sensible.
`email`	L’adresse e-mail de l’utilisateur, lorsqu’elle peut être déterminée.
`current_member`	Indique si l’utilisateur est actuellement un membre actif de la Team. Les lignes limitées à un groupe sont sélectionnées en fonction de l’appartenance actuelle au groupe, mais cet indicateur reflète toujours l’appartenance à la Team.
`total_acus`	ACU consommés par l’utilisateur au cours de la période.

Comportement

L’attribution aux groupes repose sur l’appartenance actuelle. Les totaux des groupes et les lignes d’utilisateurs par groupe reflètent les personnes qui font actuellement partie du groupe, et non celles qui en faisaient partie pendant la période. Les utilisateurs appartenant à plusieurs groupes demandés sont comptabilisés dans chacun d’eux.
Les lignes Team conservent les anciens utilisateurs. Les lignes d’utilisateurs limitées à une Team incluent les utilisateurs qui ont depuis quitté la Team ou qui n’ont pas pu être résolus ; leur indicateur current_member est défini sur false.
Seuls les utilisateurs ayant utilisé des ACU apparaissent. Les utilisateurs n’ayant consommé aucun ACU pendant la période sont omis des lignes d’utilisateurs.
Historique ou cycle actuel. Les fenêtres historiques couvrent jusqu’à 90 jours d’utilisation enregistrée, inclus. current_cycle renvoie l’utilisation en quasi temps réel pour le cycle de facturation actif ; si la Team n’a pas de bornes de cycle actif, les champs de période des métadonnées l’indiquent.
Cohérence. Les totaux et la page de lignes d’utilisateurs d’une même réponse sont calculés à partir d’un unique snapshot cohérent.

Exemples

Lignes du total de la Team et du détail par utilisateur pour le cycle en cours

curl -X POST https://<your-server>/api/v1/Analytics \
  -H "Content-Type: application/json" \
  -d '{
    "service_key": "your_service_key",
    "acu_consumption_query": {
      "current_cycle": {},
      "include_team_total": true,
      "user_scope": {"team": {}}
    }
  }'

{
  "acuConsumption": {
    "team": {
      "totalAcus": 1240.5,
      "userRows": [
        {"userId": "user_abc", "email": "dev@agency.gov", "currentMember": true, "totalAcus": 310.2}
      ]
    },
    "nextPageToken": "…",
    "metadata": {
      "periodStart": "2025-03-01T00:00:00Z",
      "periodEnd": "2025-03-14T18:22:05Z",
      "generatedAt": "2025-03-14T18:22:05Z",
      "teamId": "team_123",
      "billingMode": "ACU_CREDIT"
    }
  }
}

Répartition historique par groupe

curl -X POST https://<your-server>/api/v1/Analytics \
  -H "Content-Type: application/json" \
  -d '{
    "service_key": "your_service_key",
    "start_timestamp": "2025-01-01T00:00:00Z",
    "end_timestamp": "2025-03-31T23:59:59Z",
    "acu_consumption_query": {
      "historical": {},
      "group_ids": ["group_a", "group_b"],
      "user_scope": {"group_id": "group_a"}
    }
  }'

{
  "acuConsumption": {
    "groups": [
      {
        "groupId": "group_a",
        "groupName": "Engineering",
        "totalAcus": 512.0,
        "userRows": [
          {"userId": "user_abc", "email": "dev@agency.gov", "currentMember": true, "totalAcus": 96.4}
        ]
      },
      {"groupId": "group_b", "groupName": "Data Science", "totalAcus": 288.7}
    ],
    "metadata": {
      "periodStart": "2025-01-01T00:00:00Z",
      "periodEnd": "2025-03-31T23:59:59Z",
      "generatedAt": "2025-04-02T10:15:00Z",
      "teamId": "team_123",
      "groupIds": ["group_a", "group_b"],
      "billingMode": "ACU_CREDIT"
    }
  }
}

​Requête

​Réponse

​Comportement

​Exemples

​Lignes du total de la Team et du détail par utilisateur pour le cycle en cours

​Répartition historique par groupe

Requête

Réponse

Comportement

Exemples

Lignes du total de la Team et du détail par utilisateur pour le cycle en cours

Répartition historique par groupe