API v4 для разработчиков

Начало работы

Первый заказ

Передайте ключ, действие, ID услуги, ссылку и количество. Для новых запросов рекомендуем POST.

Старые интеграции менять не нужно.

Endpoint /api/ продолжает работать. Его явный версионный вариант — /api/v4/.

REQUEST · cURL

curl --request POST 'https://likedrom.com/api/' \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=add' \
  --data-urlencode 'service=3' \
  --data-urlencode 'link=https://t.me/group/post1' \
  --data-urlencode 'quantity=500'

RESPONSE · JSON

{
  "order": 123456
}

Ошибки возвращаются в поле error. В API v4 названия полей и статусов могут быть изменены пользователем в настройках.

Общие правила

Авторизация

Передавайте API-ключ в поле key в каждом запросе.

Авторизуйтесь, чтобы увидеть свой ключ.

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

Поля ответов и названия статусов можно настроить.

Персональные параметры API v4 находятся в настройках профиля.

Правило	Описание
`Content-Type`	`application/x-www-form-urlencoded` или обычные поля формы.
Метод	Поддерживаются GET и POST. POST безопаснее: ключ не попадает в URL и историю браузера.
Кодировка	UTF-8. Ответ возвращается в формате JSON.
Версионный URL	`https://likedrom.com/api/v4/` работает параллельно с `https://likedrom.com/api/`.

GET / POST

Создание заказа

action=add

Создаёт заказ. Алиас action=create сохранён для совместимости.

Параметр	Обязательный	Описание
`key`	Да	API-ключ аккаунта.
`action`	Да	`add` или `create`.
`service`	Да	ID услуги из ответа `services`.
`link`	Да	Полная ссылка на объект услуги.
`quantity`	Зависит от типа	Количество. Для комментариев определяется числом непустых строк.
`comments` / `list`	Для комментариев	Комментарии, каждый с новой строки. Оба имени поля поддерживаются.
`nickname`	Для mentions	Имя пользователя без символа `@`.
`posts`	Для auto	Количество будущих публикаций.

Заказ комментариев

В полях comments и list поддерживаются обычные переносы LF, CRLF, CR, а также текстовые разделители \n, \r\n и \r.

REQUEST · comments

curl --request POST 'https://likedrom.com/api/' \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=add' \
  --data-urlencode 'service=45' \
  --data-urlencode 'link=https://t.me/group/post1' \
  --data-urlencode 'comments=Первый комментарий
Второй комментарий'

Проверяйте min, max и тип услуги.

Эти значения возвращаются методом services и проверяются до создания заказа.

GET / POST

Статус заказа

action=status

Сразу возвращает сохранённые данные заказа. Актуализация активного заказа выполняется в фоне.

Проверка статуса не блокирует запрос сетевым ожиданием.

Метод читает текущий снимок и ставит обновление активного заказа в очередь.

REQUEST

curl --request POST 'https://likedrom.com/api/' \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=status' \
  --data-urlencode 'order=123456'

RESPONSE · поля по умолчанию

{
  "order": 123456,
  "charge": 4.52,
  "currency": "RUB",
  "quantity": 500,
  "start_count": 100,
  "remains": 30,
  "status": "In Progress"
}

GET / POST

Отмена заказа

action=cancel

Запрашивает отмену заказа, если выбранная услуга поддерживает эту возможность.

REQUEST

curl --request POST 'https://likedrom.com/api/' \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=cancel' \
  --data-urlencode 'order=123456'

RESPONSE

{
  "success": true
}

GET / POST

Докрутка

action=refill

Запрашивает докрутку выполненного заказа, если у услуги доступен refill.

REQUEST

curl --request POST 'https://likedrom.com/api/' \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=refill' \
  --data-urlencode 'order=123456'

RESPONSE

{
  "success": true
}

GET / POST

Каталог услуг

action=services

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

REQUEST

curl --request POST 'https://likedrom.com/api/' \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=services'

RESPONSE · сокращённый пример

[
  {
    "service": 3,
    "category_id": 12,
    "category_name": "Подписчики",
    "name_ru": "Подписчики — Стандарт",
    "network": "telegram",
    "social_network": "Telegram",
    "cost": 283.81,
    "min": 10,
    "max": 20000,
    "type": "default",
    "refill": true,
    "cancel": false
  }
]

Поле	Тип	Описание
`service`	integer	ID услуги для `add`.
`name_ru` / `name`	string	Название на русском и английском.
`category_id` / `category_name`	integer / string	Категория услуги.
`network`	string	Код социальной сети.
`cost`	number	Цена за 1000 единиц в RUB с учётом тарифа аккаунта.
`min` / `max`	integer	Допустимый диапазон количества.
`type`	string	`default`, `comments`, `mentions` или `auto`.
`refill` / `cancel`	boolean	Доступность докрутки и отмены.

GET / POST

Баланс

action=balance

Возвращает текущий баланс API-аккаунта в рублях.

REQUEST

curl --request POST 'https://likedrom.com/api/' \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=balance'

RESPONSE

{
  "balance": 1500.5,
  "currency": "RUB"
}

Справочник

Статусы заказа

Ниже указаны значения по умолчанию. В API v4 их можно переименовать в настройках профиля.

PendingЗаказ ожидает запуска.

ProcessingЗаказ принят и обрабатывается.

In ProgressВыполнение началось.

PartialВыполнена часть объёма.

CompletedЗаказ выполнен.

CanceledЗаказ отменён.

Справочник

Лимиты запросов

Стандартные лимиты считаются отдельно для API-ключа и действия за окно в 60 секунд.

Action	Запросов / 60 сек.
`status`	600
`balance`	120
`add` / `create`	120
`cancel`	60
`refill`	60
`services`	30

При превышении возвращается {"error":"too many requests"}.

Справочник

Ошибки

По умолчанию текст находится в поле error. Имя поля может быть изменено в настройках v4.

Ошибка	Что означает
`incorrect key`	Ключ отсутствует или не найден.
`incorrect action`	Действие отсутствует или не поддерживается.
`incorrect service`	Услуга не существует, отключена или недоступна.
`incorrect link`	Ссылка отсутствует или не подходит услуге.
`incorrect quantity`	Количество отсутствует или имеет неверный формат.
`incorrect list`	Не передан непустой список комментариев.
`min list quantity`	Комментариев меньше минимального количества.
`max list quantity`	Комментариев больше максимального количества.
`incorrect nickname`	Не передано корректное имя пользователя.
`incorrect posts`	Не передано количество будущих публикаций.
`min quantity`	Количество меньше минимума услуги.
`max quantity`	Количество больше максимума услуги.
`qnt is not a multiple of N`	Нарушена кратность количества.
`incorrect order`	Заказ не найден или принадлежит другому пользователю.
`no money`	Недостаточно денег на балансе.
`is already running`	Похожий заказ уже запущен.
`account is private`	Целевой профиль или публикация недоступны.
`thematics forbidden`	Ссылка заблокирована правилами тематики.
`non refillable`	Заказ нельзя поставить на докрутку.
`already on refill`	Докрутка уже запрошена.
`account is read only`	На аккаунте отключены изменяющие операции.
`too many requests`	Превышен лимит запросов.
`server error`	Временная внутренняя ошибка.

Новая версия

Переход на API v5

API v4 остаётся доступным, поэтому перенос можно выполнять постепенно без остановки интеграции.

01

Фиксированный контракт.
Поля и статусы v5 одинаковы для всех API-аккаунтов.

02

Защита создания заказа.
request_id позволяет безопасно повторить запрос после сетевого сбоя.

03

Bulk-операции.
Статусы, отмена и докрутка поддерживают несколько ID в одном запросе.

04

Отдельный endpoint.
Используйте /api/v5/; текущий /api/ продолжит вести на v4.