Перейти к документации
API

Прочитать оплату по факту

Выставляется ли использование сверх лимитов и сколько оно стоит на сейчас.

GET/billing/pay-as-you-go

Выполняет настоящий запрос в вашем рабочем пространстве.

GET /billing/pay-as-you-go

Выставляется ли использование сверх лимитов и сколько оно стоит на сейчас.

Пример

Требуется billing:read. Суммы указаны в центах США. limits это месячные лимиты, которые можно выбрать, prices это стоимость сверхлимитного использования, а period это текущий расчётный период оплаты по факту, null, пока она не настроена.

curl
curl "$OE/billing/pay-as-you-go" -H "$AUTH"
Ответ
{  "object": "pay_as_you_go",  "available": true,  "enabled": true,  "suspended": false,  "enrolled": true,  "switchedOn": true,  "coversSends": true,  "coversAiActions": true,  "limitCents": 5000,  "spentCents": 120,  "extraSends": 3000,  "extraAiActions": 0,  "estimatedCents": 120,  "limits": [1000, 2500, 5000, 10000, 25000, 50000, 100000, 250000, 500000],  "prices": {    "sends": { "unit": 1000, "priceCents": 40 },    "aiActions": { "unit": 100, "priceCents": 25 }  },  "period": {    "endsAt": "2026-11-01T09:00:00.000Z",    "sends": 3000,    "aiActions": 0,    "estimatedCents": 120  }}

enabled равен true, пока сверхлимитное использование выставляется: включено и не на паузе. suspended означает, что последний платёж не прошёл, и карту обновляют на биллинг-портале.

К оплате есть доступ только у владельца рабочего пространства: это API-ключ или токен доступа, который владелец подключил со всеми адресами. Токен участника даёт 403 owner_only, а ключ или токен, ограниченный отдельными адресами или доменами, даёт 422 capability_unsupported.

Справочник