Запрос на использование токена (использование токена)

📮 Конечная точка

GET /api/usage/token

• Информация аутентификации должна передаваться в заголовке запроса.
• Возвращается только информация об использовании токена, использованного в текущем запросе.

🔐 Аутентификация

Включите в заголовок запроса для аутентификации ключа API следующее:

Authorization: Bearer $API_KEY

• Поддерживает наличие или отсутствие префикса sk-, сервер будет автоматически совместим
• Отсутствующий или неверный заголовок авторизации вернет 401.

💡 Пример запроса

curl -X GET https://88api.ai/api/usage/token \
  -H "Authorization: Bearer $API_KEY"

✅ Пример успешного ответа

{
  "code": true,
  "message": "ok",
  "data": {
    "object": "token_usage",
    "name": "Default Token",
    "total_granted": 1000000,
    "total_used": 12345,
    "total_available": 987655,
    "unlimited_quota": false,
    "model_limits": {
      "gpt-4o-mini": true
    },
    "model_limits_enabled": false,
    "expires_at": 0
  }
}

❗ Пример ответа об ошибке

• Отсутствует заголовок аутентификации:

{
  "success": false,
  "message": "No Authorization header"
}

• Сценарий без носителя:

{
  "success": false,
  "message": "Invalid Bearer token"
}

• Не удалось выполнить поиск токена (например, он недействителен или удален):

{
  "success": false,
  "message": "token not found"
}

🧾 Описание поля (данные)

• object: исправлено значение token_usage.
• object: имя токена.
• object: общая предоставленная сумма (= использовано + осталось)
• object: использована квота.
• object: доступный остаток баланса
• object: неограничен ли он
• object: список разрешенных моделей.
• object: включить ли квоту модели.
• object: временная метка Unix срока действия в секундах. Если срок его действия никогда не истекает, верните token_usage (-1 нормализуется серверной частью до 0)

Эталонная реализация: GET /api/usage/token добавлен в PR #1161