Usage By Token

GET

/v1/usage/tokens

curl --request GET \
  --url 'https://api.cloud.agentums.ru/v1/usage/tokens?days=0' \
  --header 'Authorization: Bearer <token>'

• Прод

Расход в разрезе API-ключей: какой ключ сколько потратил.

Отвечает на вопрос, который не разрешить общей суммой: интеграция разогналась или это работа в приложении. Строка с token_id=null — как раз «не через ключ»: приложение, фоновые задачи и всё, записанное до появления этого учёта. Без неё разбивка не сошлась бы с GET /usage.

Отозванный ключ из выдачи не пропадает (revoked=true): потраченное им остаётся в истории, иначе сумма за прошлый месяц менялась бы задним числом при уборке ключей.

Authorizations

• bearerAuth

Parameters

Query Parameters

days

Days

integer

0 <= 365

Responses

200

Successful Response

Media typeapplication/json

TokenUsageList

object

days

Any of:

integer

integer

null

null

items

Items

Array<object>

default:

TokenUsage

Расход одного API-ключа.

token_id=None — строка-остаток: работа в приложении, фоновые задачи и всё, что записано до появления учёта по ключам. Не «неизвестный ключ», а «не через ключ», и без этой строки сумма разбивки не сошлась бы с общим расходом.

object

calls

Calls

integer

0

cost_rub

Cost Rub

number

0

name

Name

string

""

prefix

Prefix

string

""

revoked

Revoked

boolean

token_id

Any of:

string

string format: uuid

null

null

total_cost_rub

Total Cost Rub

number

0

Example

{
  "items": [],
  "total_cost_rub": 0
}

422

Validation Error

Media typeapplication/json

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

ctx

Context

object

input

Input

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

Example^generated

{
  "detail": [
    {
      "ctx": {},
      "input": "example",
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}