Récupérer le débit API par minute

Réponse exemple

{
  "data": [
    {
      "created_at": "2026-06-05T13:42:59.000Z",
      "error_count": 2,
      "workspace_id": "ws_3kf92ja0",
      "bucket_minute": "2026-06-05T13:42:00.000Z",
      "request_count": 128
    },
    {
      "created_at": "2026-06-05T13:43:58.000Z",
      "error_count": 0,
      "workspace_id": "ws_3kf92ja0",
      "bucket_minute": "2026-06-05T13:43:00.000Z",
      "request_count": 94
    }
  ],
  "since": "2026-06-05T12:43:00.000Z",
  "object": "list",
  "window_minutes": 60
}

Cet endpoint renvoie les échantillons de débit (throughput) collectés pour votre espace de travail, ordonnés du plus ancien au plus récent. Chaque entrée correspond à un point de mesure horodaté, ce qui permet de tracer la consommation de l'API minute par minute et de surveiller les pics de trafic. La fenêtre d'observation est contrôlée par le paramètre minutes : par défaut, l'endpoint remonte les 60 dernières minutes. Comportement notable : il s'agit d'une fonctionnalité dépendante du plan. Si les échantillons ne sont pas disponibles (table inaccessible ou fonctionnalité désactivée sur votre offre), l'endpoint répond malgré tout avec un statut 200 et une liste vide accompagnée d'un champ note explicatif, plutôt qu'une erreur.

Authentification

L'appel exige une clé API valide portant le scope quotas:read. Par alias, les scopes plus larges workspace:billing, workspace:manage et workspace:read satisfont également cette exigence (lire la consommation est considéré comme une lecture de l'espace de travail). Le scope wildcard * et le scope ressource quotas:* sont aussi acceptés. Une session dashboard authentifiée bénéficie d'un accès complet (scopes *). Toutes les données sont automatiquement restreintes à l'espace de travail résolu depuis le contexte d'authentification (workspace_id).

Paramètres de requête

Réponse

La réponse est un objet de type liste. Le champ object vaut toujours list. Le champ data contient le tableau des échantillons de débit, ordonnés par created_at croissant ; chaque échantillon est rattaché à votre workspace_id et porte son horodatage de collecte. Le champ window_minutes reflète la fenêtre effectivement appliquée (après bornage), et le champ since indique l'instant ISO 8601 à partir duquel les échantillons ont été remontés. Lorsque la fonctionnalité n'est pas disponible, data est un tableau vide et un champ note est ajouté à la place de window_minutes/since.

Erreurs

Voir aussi

• GET /v1/quotas — état courant des quotas et de la consommation de l'espace de travail.
• GET /v1/usage — agrégats de consommation facturable sur la période en cours.
• Rate limits de l'API — https://docs.coffrify.com/api/rate-limits