> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wandb.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Statistiques de feedback

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



## OpenAPI

````yaml /fr/weave/reference/service-api/openapi.json post /feedback/stats
openapi: 3.1.0
info:
  title: FastAPI
  version: 0.1.0
servers: []
security: []
paths:
  /feedback/stats:
    post:
      tags:
        - Feedback
      summary: Statistiques de feedback
      description: Renvoyer des statistiques de feedback agrégées par bucket temporel.
      operationId: feedback_stats_feedback_stats_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FeedbackStatsReq'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedbackStatsRes'
          description: Réponse réussie
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Erreur de validation
      security:
        - HTTPBasic: []
        - HTTPBearer: []
components:
  schemas:
    FeedbackStatsReq:
      additionalProperties: false
      description: >-
        Requête pour des statistiques agrégées de feedback par buckets
        temporels.
      properties:
        end:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: >-
            Heure de fin exclue (UTC, ISO 8601). Par défaut, l’heure actuelle si
            elle est omise.
          title: End
        feedback_type:
          anyOf:
            - type: string
            - type: 'null'
          description: Filtre par feedback_type.
          title: Feedback Type
        granularity:
          anyOf:
            - type: integer
            - type: 'null'
          description: >-
            Taille du bucket en secondes. Si elle est omise, elle est
            sélectionnée automatiquement en fonction de la plage temporelle.
          title: Granularity
        metrics:
          description: Métriques à agréger à partir de payload_dump.
          items:
            $ref: '#/components/schemas/FeedbackMetricSpec'
          title: Metrics
          type: array
        project_id:
          title: Project Id
          type: string
        start:
          description: Heure de début incluse (UTC, ISO 8601).
          format: date-time
          title: Start
          type: string
        timezone:
          default: UTC
          description: Fuseau horaire IANA pour l’alignement des buckets.
          title: Timezone
          type: string
        trigger_ref:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Filtre par trigger_ref (correspondance exacte ou par préfixe pour
            all-versions).
          title: Trigger Ref
      required:
        - project_id
        - start
      title: FeedbackStatsReq
      type: object
    FeedbackStatsRes:
      description: >-
        Réponse contenant des statistiques de feedback sous forme de série
        temporelle.
      properties:
        buckets:
          description: >-
            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.
          items:
            additionalProperties: true
            type: object
          title: Buckets
          type: array
        end:
          description: >-
            Heure de fin résolue (toujours en UTC, quel que soit le fuseau
            horaire demandé).
          format: date-time
          title: End
          type: string
        granularity:
          description: Taille de bucket utilisée (en secondes)
          title: Granularity
          type: integer
        start:
          description: >-
            Heure de début résolue (toujours en UTC, quel que soit le fuseau
            horaire demandé).
          format: date-time
          title: Start
          type: string
        timezone:
          description: Fuseau horaire utilisé pour l’alignement des buckets
          title: Timezone
          type: string
        window_stats:
          anyOf:
            - additionalProperties:
                additionalProperties:
                  anyOf:
                    - type: number
                    - type: 'null'
                type: object
              type: object
            - type: 'null'
          description: >-
            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.
          title: Window Stats
      required:
        - start
        - end
        - granularity
        - timezone
      title: FeedbackStatsRes
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    FeedbackMetricSpec:
      additionalProperties: false
      description: Spécification d'une métrique de payload de feedback à agréger.
      properties:
        aggregations:
          description: >-
            Fonctions d'agrégation à calculer. Si cette valeur est vide, les
            valeurs par défaut sont choisies en fonction de value_type :
            numeric->avg/min/max, boolean->count_true/count_false.
          items:
            $ref: '#/components/schemas/AggregationType'
          title: Aggregations
          type: array
        json_path:
          description: >-
            Chemin par points dans payload_dump (par ex. « output », «
            output.score »).
          title: Json Path
          type: string
        percentiles:
          description: >-
            Valeurs de percentile à calculer (0–100), par ex. [5, 50, 95].
            S'applique uniquement aux champs value_type numériques ; ignoré pour
            les champs booléens/catégoriels.
          items:
            type: number
          title: Percentiles
          type: array
        value_type:
          default: numeric
          description: >-
            Type de la valeur au chemin. numeric : avg/min/max ; boolean :
            count_true/count_false.
          enum:
            - numeric
            - boolean
            - categorical
          title: Value Type
          type: string
      required:
        - json_path
      title: FeedbackMetricSpec
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
    AggregationType:
      description: >-
        Fonctions d’agrégation prises en charge par les métriques de feedback et
        les statistiques d’appel.
      enum:
        - sum
        - avg
        - min
        - max
        - count
        - count_true
        - count_false
      title: AggregationType
      type: string
  securitySchemes:
    HTTPBasic:
      scheme: basic
      type: http
    HTTPBearer:
      scheme: bearer
      type: http

````