Statistiques de feedback

Renvoyer des statistiques de feedback agrégées par bucket temporel.

POST /feedback/stats

Statistiques de feedback

cURL

curl --request POST \
  --url https://api.example.com/feedback/stats \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "project_id": "<string>",
  "start": "2023-11-07T05:31:56Z",
  "end": "2023-11-07T05:31:56Z",
  "feedback_type": "<string>",
  "trigger_ref": "<string>",
  "granularity": 123,
  "timezone": "UTC",
  "metrics": [
    {
      "json_path": "<string>",
      "value_type": "numeric",
      "aggregations": [
        "sum"
      ],
      "percentiles": [
        123
      ]
    }
  ]
}
'

200

{
  "start": "2023-11-07T05:31:56Z",
  "end": "2023-11-07T05:31:56Z",
  "granularity": 123,
  "timezone": "<string>",
  "buckets": [
    {}
  ],
  "window_stats": {}
}

Autorisations

Authorization · string · header · requis

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Corps

application/json

Requête pour des statistiques agrégées de feedback par buckets temporels.

project_id · string · requis

start · string<date-time> · requis

Heure de début incluse (UTC, ISO 8601).

end · string<date-time> | null

Heure de fin exclue (UTC, ISO 8601). Par défaut, l’heure actuelle si elle est omise.

feedback_type · string | null

Filtre par feedback_type.

trigger_ref · string | null

Filtre par trigger_ref (correspondance exacte ou par préfixe pour all-versions).

granularity · integer | null

Taille du bucket en secondes. Si elle est omise, elle est sélectionnée automatiquement en fonction de la plage temporelle.

timezone · string · défaut: UTC

Fuseau horaire IANA pour l’alignement des buckets.

metrics · FeedbackMetricSpec · object[]

Métriques à agréger à partir de payload_dump.

Show child attributes

Réponse

200

application/json

Réponse réussie

Réponse contenant des statistiques de feedback sous forme de série temporelle.

start · string<date-time> · requis

Heure de début résolue (toujours en UTC, quel que soit le fuseau horaire demandé).

end · string<date-time> · requis

Heure de fin résolue (toujours en UTC, quel que soit le fuseau horaire demandé).

granularity · integer · requis

Taille de bucket utilisée (en secondes)

timezone · string · requis

Fuseau horaire utilisé pour l’alignement des buckets

buckets · Buckets · object[]

Agrégations par bucket temporel. Chaque dict contient les clés 'timestamp' (chaîne ISO), 'count' (int) et '{agg}_{slug}' pour chaque paire métrique+agrégation demandée.

window_stats · Window Stats · object

Agrégations sur l’ensemble de la fenêtre de requête, indexées par slug de métrique (par ex. 'output_score'). Chaque valeur associe le nom de l’agrégation au résultat.

Show child attributes