calls 사용량

여러 루트 call의 집계 사용량을 하위 항목 롤업과 함께 계산합니다.

POST /calls/usage

calls 사용량

cURL

curl --request POST \
  --url https://api.example.com/calls/usage \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "project_id": "<string>",
  "call_ids": [
    "<string>"
  ],
  "include_costs": false,
  "limit": 10000
}
'

200

{
  "call_usage": {},
  "unfinished_call_ids": [
    "<string>"
  ]
}

인증

Authorization · string · header · 필수

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

본문

application/json

여러 루트 call의 집계된 사용량을 계산하기 위한 요청입니다.

이 엔드포인트는 요청된 각 루트 call에 대한 사용 메트릭을 반환하며, 각 루트의 메트릭에는 해당 루트 자체의 사용량과 모든 하위 항목의 사용량 합계가 포함됩니다.

참고: 집계를 위해 일치하는 모든 call이 메모리에 로드됩니다. 결과 집합이 매우 큰 경우(>10k calls)에는 루트 call ID를 배치로 나누어 처리하거나 애플리케이션 계층에서 더 좁은 필터를 사용하는 것을 고려하세요.

project_id · string · 필수

call_ids · string[] · 필수

집계할 루트 call ID입니다. 각 결과 키는 입력 call ID 하나에 해당합니다.

include_costs · boolean · 기본값: false

true이면 사용량에 비용 계산을 포함합니다.

limit · integer · 기본값: 10000

모든 트레이스에서 처리할 최대 call 수입니다. 무제한적인 메모리 사용을 방지하기 위한 안전 한도로 작동합니다.

응답

200

application/json

성공적인 응답

루트 call별 집계된 사용 메트릭이 포함된 응답입니다.

call_usage · Call Usage · object

Show child attributes

unfinished_call_ids · string[]