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

Показать уведомления об оплате

Что сейчас сказал бы баннер оплаты в приложении, самое срочное первым.

GET/billing/alerts

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

GET /billing/alerts

Что сейчас сказал бы баннер оплаты в приложении, самое срочное первым.

Пример

Требуется billing:read. kind принимает payment_failed, pay_as_you_go_paused, sending_paused, spend_limit_reached, ai_used_up, plan_ending, sends_nearly_used, spend_nearly_reached или upcoming_charge, а target говорит, касается ли оно тарифа или использования. Пустой список означает, что сказать нечего.

curl
curl "$OE/billing/alerts" -H "$AUTH"
Ответ
{  "object": "list",  "data": [    {      "object": "billing_alert",      "id": "upcoming_charge:plan:2026-11-01T09:00:00.000Z",      "kind": "upcoming_charge",      "severity": "info",      "target": "billing",      "planName": "Business",      "at": "2026-11-01T09:00:00.000Z",      "cents": 10000,      "currency": "usd",      "used": null,      "limit": null,      "payAsYouGo": false    }  ]}

Уведомление сохраняет свой id, пока верно то же самое, поэтому скрытое кем-то уведомление может оставаться скрытым.

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

Справочник