Likedrom Developers
Документация API v5
Единый JSON-контракт для создания заказов, получения статусов и управления услугами. API v5 работает отдельно от v4, поэтому существующие интеграции продолжат работать без изменений.
https://likedrom.com/api/v5/
Первый заказ
Передайте ключ, действие, ID услуги, ссылку и количество одним POST-запросом.
request_id.
При повторе того же запроса API вернёт прежний ID и не создаст повторный заказ.
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'
{
"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-логи. |
Баланс
action=balance
Возвращает текущий баланс API-аккаунта в рублях.
curl --request POST 'https://likedrom.com/api/v5/' \
--data-urlencode 'key=YOUR_API_KEY' \
--data-urlencode 'action=balance'
{
"balance": "1500.5",
"currency": "RUB"
}
Каталог услуг
action=services
Возвращает все включённые услуги, доступные для заказа через API.
curl --request POST 'https://likedrom.com/api/v5/' \
--data-urlencode 'key=YOUR_API_KEY' \
--data-urlencode 'action=services'
[
{
"service": 3,
"name": "Подписчики — Стандарт",
"type": "Default",
"category": "Telegram — Подписчики",
"rate": "283.81",
"min": "10",
"max": "20000",
"refill": true,
"cancel": false
}
]
| Поле | Тип | Описание |
|---|---|---|
service | integer | ID услуги для метода add. |
name | string | Название услуги. |
type | string | Тип заказа: Default, Custom Comments, Mentions, Hashtag, Poll или Subscriptions. |
category | string | Социальная сеть и категория услуги. |
rate | string | Стоимость за 1000 единиц в RUB. |
min / max | string | Минимальное и максимальное количество. |
refill | boolean | Доступна ли докрутка. |
cancel | boolean | Доступна ли отмена. |
description | string | Описание услуги, если оно заполнено. |
Создание заказа
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.
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 | Дополнительные поля | Как считается количество |
|---|---|---|
Default | quantity | Переданное значение. |
Custom Comments | comments или list | Число непустых строк. |
Mentions | quantity, nickname | Переданное значение. Алиасы ника: username, mentions_username. |
Hashtag | quantity, hashtag | Переданное значение. Алиас тега: tag. |
Poll | quantity, answer | Переданное значение. Алиасы ответа: poll_index, vote. |
Subscriptions | quantity, posts | quantity × posts. |
Статус заказа
action=status
Сразу возвращает текущий сохранённый статус. Для активного заказа актуализация автоматически выполняется в фоне.
status не меняет баланс, не делает возврат и не создаёт финансовую транзакцию.
Один заказ
curl --request POST 'https://likedrom.com/api/v5/' \
--data-urlencode 'key=YOUR_API_KEY' \
--data-urlencode 'action=status' \
--data-urlencode 'order=123456'
{
"charge": "4.52",
"start_count": "100",
"status": "In progress",
"remains": "30",
"currency": "RUB"
}
Несколько заказов
Передайте до 100 уникальных ID через запятую в поле orders.
curl --request POST 'https://likedrom.com/api/v5/' \
--data-urlencode 'key=YOUR_API_KEY' \
--data-urlencode 'action=status' \
--data-urlencode 'orders=123456,123457,123458'
{
"123456": {
"charge": "4.52",
"start_count": "100",
"status": "Completed",
"remains": "0",
"currency": "RUB"
},
"123457": {
"error": "Incorrect order ID"
}
}
Отмена заказа
action=cancel
Запрашивает отмену, если услуга поддерживает её и заказ ещё можно остановить.
curl --request POST 'https://likedrom.com/api/v5/' \
--data-urlencode 'key=YOUR_API_KEY' \
--data-urlencode 'action=cancel' \
--data-urlencode 'order=123456'
{
"success": true
}
Для bulk передайте orders=123456,123457. Максимум 20 ID. Алиас действия:
multi_cancel.
Докрутка
action=refill
Ставит выполненный заказ на докрутку, если у услуги есть поддержка refill.
curl --request POST 'https://likedrom.com/api/v5/' \
--data-urlencode 'key=YOUR_API_KEY' \
--data-urlencode 'action=refill' \
--data-urlencode 'order=123456'
{
"success": true
}
Для bulk передайте orders=123456,123457. Максимум 20 ID. Алиас действия:
multi_refill.
Статусы заказа
Названия полей и статусов в v5 фиксированы и не зависят от персональных настроек ответа v4.
PendingЗаказ ожидает запуска.ProcessingЗаказ принят и обрабатывается.In progressВыполнение началось.PartialВыполнена часть объёма, остаток возвращён или остановлен.CompletedЗаказ выполнен.CanceledЗаказ отменён.Лимиты запросов
Лимиты считаются отдельно для API-ключа и действия за окно в 60 секунд.
| Action | Запросов / 60 сек. | Bulk-лимит |
|---|---|---|
status | 600 | 100 заказов |
balance | 120 | — |
add | 120 | — |
cancel | 60 | 20 заказов |
refill | 60 | 20 заказов |
services | 30 | — |
При превышении возвращается {"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 ID | request_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 used | request_id уже связан с другими параметрами. |
Request requires review | Результат прошлого запроса неопределён; не создавайте новый дубль автоматически. |
Order is busy | С заказом уже выполняется другое изменение. |
Too many requests | Превышен лимит запросов. |
Server error | Временная внутренняя ошибка. |
Переход с API v4
Переключайте интеграции постепенно: v4 и v5 работают параллельно.
Замените только endpoint./api/v4/ → /api/v5/.
Оставьте привычные алиасы при необходимости.create, list и multi_status поддерживаются.
Добавьте request_id.
Храните его вместе с локальным заказом и повторяйте неизменным при сетевом сбое.
Используйте фиксированные поля ответа.
Персональные переименования полей из настроек v4 в v5 не применяются.
status не ждёт сетевую актуализацию.
Метод сразу возвращает текущие данные, а их обновление выполняется в фоне.
request_id после таймаута.
Сначала повторите тот же запрос. Если API вернул Request requires review, проверьте заказ вручную или обратитесь в поддержку.