Кто я и баланс

Пользователь, баланс, права и траты ключа.

GET /api/me · чтение

Работает и при нулевом балансе — по нему ваш сервер узнаёт, почему остальные запросы отвечают 402.

Что в ответе

Поле Что это
user Почта и имя владельца ключа
balance Знаков на балансе
unlimited Баланс без лимита (служебные учётки)
api_allowed API доступен (куплена «Студия» и есть знаки)
weights Вес цены по видам голосов
key.scope Права ключа: read, voice, full
key.char_limit Свой лимит знаков ключа или null
key.used / key.left Потрачено этим ключом / осталось до лимита
key.rate_per_minute Запросов в минуту

Ошибки

Код Когда
401 Ключ неверный или отозван 
curl "https://golosar-kniga.tech/api/v1/api/me" \
  -H "x-api-key: $KEY"

import os, requests

API = "https://golosar-kniga.tech/api/v1"
H = {"x-api-key": os.environ["GOLOSAR_KEY"]}

r = requests.get(f"{API}/api/me", headers=H)
r.raise_for_status()
print(r.json())

const API = "https://golosar-kniga.tech/api/v1";
const H = { "x-api-key": process.env.GOLOSAR_KEY };

const r = await fetch(`${API}/api/me`, { headers: H });
if (!r.ok) throw new Error(await r.text());
console.log(await r.json());

json Ответ 200 { "user": { "email": "you@example.com", "name": "Иван" }, "balance": 1834512.5, "unlimited": false, "api_allowed": true, "weights": { "local": 0.1, "own": 1.0, "cloud": 3.0 }, "key": { "name": "мой сервис", "prefix": "gk_live_zRgV", "scope": "full", "char_limit": null, "used": 15488.0, "left": null, "rate_per_minute": 120 } }