Начало работы

Эти GET-методы читают данные только текущего аккаунта. Основной аккаунт не получает автоматического доступа к данным субаккаунтов. Администраторы также могут читать только свои данные. Используется системный токен доступа, отличный от API-ключа модели.

Получение системного токена доступа

Войдите в консоль и создайте токен в разделе System Access Token на странице настроек. Повторное создание аннулирует предыдущий токен, поэтому обновите существующие интеграции. Эти запросы доступны только для чтения, но сам токен сохраняет прежние права в старых API и не является строго read-only.

Передавайте ровно один заголовок Authorization. Cookie, учетные данные в URL, ключи моделей, токены Agent и MCP не подходят. X-User-Id не требуется. Необязательный X-Locale поддерживает en, zh, zh-TW, ja, ko, ru; иначе применяются настройки аккаунта и согласование языка.

curl --request GET \
  --url 'https://toapis.com/api/v1/account' \
  --header 'Authorization: Bearer YOUR_SYSTEM_ACCESS_TOKEN'

Ответы и суммы

Успех возвращает HTTP 200, code=0, message="". Ошибки сохраняют реальный HTTP-статус и числовой код. Проверяйте HTTP-статус и code, а не локализованное message. ID и суммы являются строками, время имеет формат RFC 3339 с часовым поясом. Неизвестные или неприменимые значения равны null, если это предусмотрено контрактом.

USD и credits для баланса и использования рассчитываются из одного снимка квоты. Используйте возвращенный credits_per_usd, не фиксируйте коэффициент старого API. Платежные суммы сохраняют исходную валюту и не смешиваются с credits.

Ответы включают Cache-Control: private, no-store и X-Request-Id. Этот ID относится к текущему запросу, а не к исходной генерации в записи использования.

{"code": 0, "message": "", "data": {"items": [], "has_more": false, "next_cursor": null, "meta": {}}}

Пагинация и диапазоны времени

Списки возвращают data.items, has_more, next_cursor, meta. Пустой список равен [], последний курсор равен null. Передавайте next_cursor без изменений как cursor, сохраняя фильтры. При изменении фильтров начните заново. Не разбирайте курсор. Общее число записей по умолчанию не вычисляется.

Время сравнивается в полуоткрытом UTC-интервале [from,to). Границы для хранения с точностью до секунды округляются вверх. from и to передаются вместе; для использования оба обязательны. Задачи по умолчанию охватывают 24 часа, максимум 31 день. Пополнения и счета по умолчанию охватывают 31 день, максимум 366 дней. Диапазон по умолчанию фиксируется на первой странице, далее время можно не указывать. Неизвестные параметры, повторяющиеся скаляры и некорректное экранирование возвращают 400.

Лимиты и ошибки

Общий бюджет пользователя составляет 120 запросов в минуту. Сводка использования ограничена дополнительно 6 запросами в минуту; список и детали счетов делят отдельный бюджет 6 запросов в минуту. При 429 соблюдайте Retry-After с небольшим случайным ожиданием. Без Redis легкие запросы ограничены на каждом узле 30 запросами в минуту на IP-корзину и пользователя; сводка и счета возвращают 503.

{
  "code": 10004,
  "message": "Invalid query parameters.",
  "data": {
    "param": "limit",
    "request_id": "request_example_query"
  }
}

Охват данных

Использование представляет изменяемый снимок журнала потребления. Расчеты и возвраты могут менять старые строки, поэтому это не полный реестр чистых расходов. Задачи возвращают сохраненные метаданные и подтвержденные начисления, без результатов, опроса провайдера, расчетов и возвратов. Пополнения не включают ручные подарки и отдельные офлайн-возвраты. Счета охватывают только текущего проверенного Stripe Customer.

Существующие API

Баланс токена, баланс пользователя и создание токена сохраняют свои контракты. Эта группа использует системный токен и ответы code/message/data. Запрос задач аккаунта не заменяет получение результатов генерации.