API Крутилочка.РФ: как подключить накрутку к своей панели за 10 минут

API нужен, чтобы заказы клиентов вашей панели или сайта улетали к поставщику автоматически, без ручного копирования ссылок. Ниже — реальные методы API Крутилочка.РФ и как ими пользоваться.

Где взять ключ

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

Базовые параметры

Метод — POST, адрес — https://xn--80apfbeslqi8b.xn--p1ai/api/v1, формат ответа — JSON. Каждый запрос передаёт ваш key и параметр action, который определяет, что именно нужно сделать.

Список услуг — action=services

Возвращает весь доступный каталог: ID услуги, название, категорию, цену за 1000 (rate), минимальный и максимальный объём заказа, а также поддержку дозаливки (dripfeed). Этот список стоит кешировать на своей стороне и обновлять раз в несколько часов — он и есть тот прайс-лист, из которого складывается ваша наценка.

Оформление заказа — action=add

Минимальный набор параметров: key, action=add, service (ID услуги из списка выше), link (ссылка на страницу/профиль/пост) и quantity (нужный объём). В ответ приходит номер заказа:

{"status": "success", "order": 32}

Проверка статуса — action=status

По одному заказу: action=status и order — в ответе статус (pending, processing, completed и т.д.), списанная сумма и остаток. По нескольким сразу — тот же метод, но параметр orders со списком номеров через запятую: удобно, чтобы одним запросом обновить статусы у всех клиентов панели, а не дёргать API отдельно на каждый заказ.

Баланс — action=balance

Возвращает текущий остаток на счету — полезно проверять перед массовым размещением заказов, чтобы не получить отказ по нехватке средств посреди партии.

Итог

Четырёх методов — services, add, status, balance — достаточно, чтобы полностью автоматизировать перепродажу: получать актуальные цены, отправлять заказы клиентов и синхронизировать статусы. Полная документация с примерами ответов — на странице API. Зарегистрируйтесь, чтобы получить свой ключ.