메인 콘텐츠로 건너뛰기
POST
/
feedback
/
stats
피드백 통계
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
      ]
    }
  ]
}
'
{
  "start": "2023-11-07T05:31:56Z",
  "end": "2023-11-07T05:31:56Z",
  "granularity": 123,
  "timezone": "<string>",
  "buckets": [
    {}
  ],
  "window_stats": {}
}

인증

​
Authorization
string
header
필수

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

본문

application/json

시간 버킷별로 집계된 피드백 통계 요청입니다.

​
project_id
string
필수
​
start
string<date-time>
필수

시작 시간(포함, UTC, ISO 8601)입니다.

​
end
string<date-time> | null

종료 시간(미포함, UTC, ISO 8601)입니다. 생략하면 현재 시간이 기본값으로 사용됩니다.

​
feedback_type
string | null

feedback_type으로 필터링합니다.

​
trigger_ref
string | null

trigger_ref로 필터링합니다(all-versions의 경우 정확히 일치 또는 접두사 일치).

​
granularity
integer | null

버킷 크기(초 단위)입니다. 생략하면 시간 범위를 기준으로 자동 선택됩니다.

​
timezone
string
기본값:UTC

버킷 정렬에 사용할 IANA 시간대입니다.

​
metrics
FeedbackMetricSpec · object[]

payload_dump에서 집계할 메트릭입니다.

응답

성공 응답

시계열 피드백 통계를 포함한 응답입니다.

​
start
string<date-time>
필수

확정된 시작 시간입니다(요청한 시간대와 관계없이 항상 UTC).

​
end
string<date-time>
필수

확정된 종료 시간입니다(요청한 시간대와 관계없이 항상 UTC).

​
granularity
integer
필수

사용된 버킷 크기(초 단위)입니다.

​
timezone
string
필수

버킷 정렬에 사용된 시간대입니다.

​
buckets
Buckets · object[]

시간 버킷별 집계입니다. 각 dict에는 'timestamp'(ISO 문자열), 'count'(int), 그리고 요청된 각 메트릭+집계에 대한 '{agg}_{slug}' 키가 포함됩니다.

​
window_stats
Window Stats · object

전체 쿼리 기간에 대한 집계이며, 메트릭 슬러그(예: 'output_score')를 키로 사용합니다. 각 값은 agg 이름을 결과에 매핑합니다.