Документация API

Подключение

Ключ API, адрес запросов и баланс.

Ключ доступа

Ключ создаётся в кабинете в разделе «Ключи доступа» после подтверждения почты. Секрет показывается один раз: храните его на своём сервере, в браузер и в открытый код не кладите.

Открыть ключи доступа

Ключ потерян или мог утечь: отзовите его в кабинете и создайте новый. Отозванный ключ перестаёт работать сразу.

Адрес и заголовки

URL

https://api.cyhub.ai/v1

В каждом запросе заголовок Authorization. Тело запросов это JSON в UTF-8 с Content-Type: application/json.

HTTP

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Язык текстов в ответах (сообщения об ошибках, описания моделей): заголовок Accept-Language: ru или en, либо ?lang=ru в адресе. Без них русский.

Баланс

cURL

curl "https://api.cyhub.ai/v1/me" \
  -H "Authorization: Bearer YOUR_API_KEY"

В ответе id (номер кабинета), platform, key (каким ключом сделан запрос) и wallets. У кошелька balance_minor (всё на балансе), reserved_minor (удержано задачами в работе) и available_minor (доступно новым задачам). Суммы в минорных единицах: 15000 это 150 ₽.

Баланс общий с Telegram и MAX, если кабинеты связаны. Пополнение сейчас в RUB, на странице «Баланс» в кабинете.

Пополнить баланс