Новая версия

Likedrom Developers

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

Единый JSON-контракт для создания заказов, получения статусов и управления услугами. API v5 работает отдельно от v4, поэтому существующие интеграции продолжат работать без изменений.

Endpoint https://likedrom.com/api/v5/
HTTPS транспорт JSON ответы POST для изменений request_id защита от дублей
Начало работы

Первый заказ

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

Всегда передавайте request_id.

При повторе того же запроса API вернёт прежний ID и не создаст повторный заказ.

REQUEST · cURL
curl --request POST 'https://likedrom.com/api/v5/' \
  --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' \
  --data-urlencode 'request_id=my-order-10001'
RESPONSE · 200 JSON
{
  "order": 123456
}

Ответ с ошибкой имеет вид {"error":"Текст ошибки"}. Для совместимости с существующими интеграциями проверяйте поле error, а не только HTTP-код.

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

Авторизация и формат

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

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

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

Правило Описание
Content-Type application/x-www-form-urlencoded или обычные POST-поля.
Кодировка UTF-8. Ответы: application/json; charset=utf-8.
Метод запроса add, cancel и refill — только POST. Остальные методы принимают GET и POST.
Рекомендация Используйте POST для всех методов, чтобы API-ключ не попадал в историю URL и access-логи.
GET / POST

Баланс

action=balance

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

REQUEST · cURL
curl --request POST 'https://likedrom.com/api/v5/' \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=balance'
RESPONSE
{
  "balance": "1500.5",
  "currency": "RUB"
}
GET / POST

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

action=services

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

REQUEST · cURL
curl --request POST 'https://likedrom.com/api/v5/' \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=services'
RESPONSE · сокращённый пример
[
  {
    "service": 3,
    "name": "Подписчики — Стандарт",
    "type": "Default",
    "category": "Telegram — Подписчики",
    "rate": "283.81",
    "min": "10",
    "max": "20000",
    "refill": true,
    "cancel": false
  }
]
ПолеТипОписание
serviceintegerID услуги для метода add.
namestringНазвание услуги.
typestringТип заказа: Default, Custom Comments, Mentions, Hashtag, Poll или Subscriptions.
categorystringСоциальная сеть и категория услуги.
ratestringСтоимость за 1000 единиц в RUB.
min / maxstringМинимальное и максимальное количество.
refillbooleanДоступна ли докрутка.
cancelbooleanДоступна ли отмена.
descriptionstringОписание услуги, если оно заполнено.
POST

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

action=add

Создаёт один заказ и возвращает его локальный ID в Likedrom.

ПараметрОбязательныйОписание
keyДаAPI-ключ аккаунта.
actionДаadd. Алиас create также принимается.
serviceДаID из ответа services.
linkДаПолная ссылка на профиль, публикацию или другой объект услуги.
quantityЗависит от типаКоличество. Для комментариев вычисляется по числу строк.
request_idРекомендуетсяУникальная строка до 64 символов: латиница, цифры, ., _, :, -.

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

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

REQUEST · Custom Comments
curl --request POST 'https://likedrom.com/api/v5/' \
  --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=Первый комментарий
Второй комментарий' \
  --data-urlencode 'request_id=comments-10002'
Соблюдайте ограничения услуги.

API проверяет min, max и кратность до списания денег и создания заказа.

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

Параметры по типам услуг

Ориентируйтесь на поле type в ответе метода services.

typeДополнительные поляКак считается количество
DefaultquantityПереданное значение.
Custom Commentscomments или listЧисло непустых строк.
Mentionsquantity, nicknameПереданное значение. Алиасы ника: username, mentions_username.
Hashtagquantity, hashtagПереданное значение. Алиас тега: tag.
Pollquantity, answerПереданное значение. Алиасы ответа: poll_index, vote.
Subscriptionsquantity, postsquantity × posts.
GET / POST

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

action=status

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

Быстрый и безопасный read-only метод.

status не меняет баланс, не делает возврат и не создаёт финансовую транзакцию.

Один заказ

REQUEST
curl --request POST 'https://likedrom.com/api/v5/' \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=status' \
  --data-urlencode 'order=123456'
RESPONSE
{
  "charge": "4.52",
  "start_count": "100",
  "status": "In progress",
  "remains": "30",
  "currency": "RUB"
}

Несколько заказов

Передайте до 100 уникальных ID через запятую в поле orders.

REQUEST · bulk
curl --request POST 'https://likedrom.com/api/v5/' \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=status' \
  --data-urlencode 'orders=123456,123457,123458'
RESPONSE · bulk
{
  "123456": {
    "charge": "4.52",
    "start_count": "100",
    "status": "Completed",
    "remains": "0",
    "currency": "RUB"
  },
  "123457": {
    "error": "Incorrect order ID"
  }
}
POST

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

action=cancel

Запрашивает отмену, если услуга поддерживает её и заказ ещё можно остановить.

REQUEST
curl --request POST 'https://likedrom.com/api/v5/' \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=cancel' \
  --data-urlencode 'order=123456'
RESPONSE
{
  "success": true
}

Для bulk передайте orders=123456,123457. Максимум 20 ID. Алиас действия: multi_cancel.

POST

Докрутка

action=refill

Ставит выполненный заказ на докрутку, если у услуги есть поддержка refill.

REQUEST
curl --request POST 'https://likedrom.com/api/v5/' \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=refill' \
  --data-urlencode 'order=123456'
RESPONSE
{
  "success": true
}

Для bulk передайте orders=123456,123457. Максимум 20 ID. Алиас действия: multi_refill.

Справочник

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

Названия полей и статусов в v5 фиксированы и не зависят от персональных настроек ответа v4.

PendingЗаказ ожидает запуска.
ProcessingЗаказ принят и обрабатывается.
In progressВыполнение началось.
PartialВыполнена часть объёма, остаток возвращён или остановлен.
CompletedЗаказ выполнен.
CanceledЗаказ отменён.
Справочник

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

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

ActionЗапросов / 60 сек.Bulk-лимит
status600100 заказов
balance120—
add120—
cancel6020 заказов
refill6020 заказов
services30—

При превышении возвращается {"error":"Too many requests"}, а заголовок Retry-After подсказывает время ожидания.

Справочник

Ошибки

Текст ошибки всегда находится в поле error.

ОшибкаЧто означает
Incorrect API keyКлюч отсутствует или не найден.
Incorrect actionНеизвестное действие.
POST requiredИзменяющий метод отправлен через GET.
Incorrect serviceУслуга не существует, отключена или недоступна через API.
Incorrect linkСсылка отсутствует или не подходит услуге.
Incorrect quantityКоличество отсутствует или имеет неверный формат.
Incorrect commentsДля услуги комментариев не передан непустой список.
Incorrect nickname / hashtag / poll answer / postsНе передан обязательный параметр выбранного типа услуги.
Incorrect request IDrequest_id не соответствует допустимому формату.
Minimum quantity is NКоличество меньше минимума услуги.
Maximum quantity is NКоличество больше максимума услуги.
Quantity must be a multiple of NНарушена кратность услуги.
Thematics forbiddenСсылка заблокирована правилами тематики.
No moneyНедостаточно денег на балансе пользователя.
Demo accountДля демонстрационного аккаунта API недоступно.
Account is read onlyНа аккаунте включён режим без изменяющих операций.
Incorrect order IDЗаказ не найден или принадлежит другому пользователю.
Non cancelableЗаказ нельзя отменить.
Cancellation failedЗапрос отмены не удалось выполнить.
Non refillableЗаказ нельзя поставить на докрутку.
Already on refillДокрутка уже запрошена.
Refill failedЗапрос докрутки не удалось выполнить.
Request is processingЗапрос с этим request_id ещё выполняется.
Request ID already usedrequest_id уже связан с другими параметрами.
Request requires reviewРезультат прошлого запроса неопределён; не создавайте новый дубль автоматически.
Order is busyС заказом уже выполняется другое изменение.
Too many requestsПревышен лимит запросов.
Server errorВременная внутренняя ошибка.
Совместимость

Переход с API v4

Переключайте интеграции постепенно: v4 и v5 работают параллельно.

01

Замените только endpoint.
/api/v4/ → /api/v5/.

02

Оставьте привычные алиасы при необходимости.
create, list и multi_status поддерживаются.

03

Добавьте request_id.
Храните его вместе с локальным заказом и повторяйте неизменным при сетевом сбое.

04

Используйте фиксированные поля ответа.
Персональные переименования полей из настроек v4 в v5 не применяются.

05

status не ждёт сетевую актуализацию.
Метод сразу возвращает текущие данные, а их обновление выполняется в фоне.

Не меняйте request_id после таймаута.

Сначала повторите тот же запрос. Если API вернул Request requires review, проверьте заказ вручную или обратитесь в поддержку.

Главная Баланс Новый заказ Мои заказы Поддержка