Подключите SOCGAINER к своему приложению. API использует HTTPS, POST и возвращает JSON. Создание заказа оплачивается только с баланса личного кабинета.
Получите ключ
Откройте Настройки профиля → Доступ по API. Сначала установите пароль, затем создайте ключ и сохраните его: полностью он показывается один раз. Перевыпуск или отключение ключа немедленно закрывает доступ по старому ключу. После смены пароля создайте новый API-ключ.
Адрес и авторизация
POST https://socgainer.ru/api/v2Content-Type: application/x-www-form-urlencoded или application/json. Ключ передавайте в поле key либо заголовке Authorization: Bearer ВАШ_КЛЮЧ. Не размещайте его в публичном JavaScript. Авторизация через cookie здесь не используется.
Проверка через браузер
GET-запросы через адресную строку доступны только для balance, services и status. Например:
https://socgainer.ru/api/v2?key=ВАШ_КЛЮЧ&action=balance
https://socgainer.ru/api/v2?key=ВАШ_КЛЮЧ&action=services
https://socgainer.ru/api/v2?key=ВАШ_КЛЮЧ&action=status&order=123Внимание: ключ в URL сохраняется в истории браузера и может попасть в журналы запросов. Не пересылайте такие ссылки и не публикуйте скриншоты с ключом. Для постоянной интеграции используйте POST с Authorization. Создание заказа, отмена и восстановление доступны только через POST: обновление страницы не должно повторять финансовые операции.
Методы
| action | Параметры | Результат |
|---|---|---|
services | — | Список доступных услуг: service, name, category, type, rate, min, max, increment, refill, cancel, description. rate — цена за 1000 единиц в рублях с учётом персональной цены и скидки. increment=0 — без ограничения кратности. |
balance | — | balance — доступный баланс в рублях строкой с двумя знаками; currency: RUB. |
add | service, link, quantity; request_id рекомендуется | service — числовой ID SOCGAINER, link — одна ссылка, quantity — количество. Ответ: order — числовой номер заказа. |
status | order либо orders | Один ID или до 100 ID через запятую. charge — стоимость с учётом возвратов, start_count — начальное число, status, remains, currency, link, quantity. Неизвестные счётчики имеют null. |
cancel | order | Запрос отмены своего заказа, только если услуга поддерживает отмену. Это не административный возврат; результат поставщика проверяется отдельно. |
refill | order | Запрос восстановления своего выполненного заказа, если услуга поддерживает его и срок гарантии не истёк. |
Пример создания заказа
curl https://socgainer.ru/api/v2 \
+ -H 'Authorization: Bearer ВАШ_КЛЮЧ' \
+ --data-urlencode 'action=add' \
+ --data-urlencode 'service=297' \
+ --data-urlencode 'link=https://t.me/channel/123' \
+ --data-urlencode 'quantity=100' \
+ --data-urlencode 'request_id=order_my_system_0001'
Ответ: {"order":123}ID, минимум, максимум и стоимость всегда берите из services: пример не гарантирует наличие конкретной услуги. Подписки через API не доступны. Сумма подтверждается сервером при создании; при недостаточном балансе заказ не создаётся.
Повторные запросы
Для add передавайте уникальный request_id длиной 16–100 символов: латинские буквы, цифры, _ и -. При сетевом сбое повторите те же параметры и тот же request_id: вернётся тот же заказ, без повторного списания. Изменение параметров с прежним request_id даст IDEMPOTENCY_CONFLICT. Без request_id каждый add считается новым заказом. Расчёт неуспешного заказа действует 10 минут; после истечения создайте новый request_id.
Проверка статуса
curl https://socgainer.ru/api/v2 \
+ -H 'Authorization: Bearer ВАШ_КЛЮЧ' \
+ --data 'action=status&orders=123,124'
{"123":{"charge":"0.22","start_count":1000,"status":"Completed","remains":0,"currency":"RUB","link":"https://t.me/channel/123","quantity":100}}Статусы: Pending, In progress, Completed, Partial, Canceled, Review, Awaiting payment. Для Completed, Partial и Canceled дальнейший опрос не требуется. Проверяйте статусы не чаще раза в минуту. Вы получаете только заказы своего аккаунта и номера SOCGAINER.
Лимиты и ошибки
До 120 запросов в минуту на аккаунт и 240 на IP, до 100 заказов в одном status. Не передавайте несколько ссылок одним add — создавайте отдельные запросы с отдельными request_id. Ошибка возвращается как {"error":"Сообщение","code":"КОД"}: 401 — неверный/отключённый ключ, 403 — ограничение доступа, 404 — заказ не найден, 409 — конфликт повторного запроса, 422 — неверные параметры или недостаток средств, 429 — превышен лимит. При 429 подождите минуту; add повторяйте с тем же request_id.