Ильдар Н.
Подписчики в X пришли за ночь
Оформил 4 500 подписчиков на аккаунт в X поздно вечером, к утру счётчик показывал полную цифру. За две недели просело на пару десятков, для этой площадки это нормально.
API SMM-панели: автоматизируйте свои заказы
Получайте список услуг, создавайте заказы, проверяйте статус и баланс через наш стандартный API реселлера. Один endpoint с ответами в JSON, который подключается к вашему панельному софту за считанные минуты.
Один endpoint · 7 действий · Ответы в JSON
4,41 506 отзывовСтандартный API реселлера
API использует стандартный формат реселлера, принятый в отрасли. Большинство готовых панельных программ и скриптов начинают работать с PanelFollows после замены только URL API и ключа.
Один endpoint
Все запросы идут на один URL; никаких дополнительных путей и жонглирования версиями. Операция выбирается параметром action.
POST в формате form-encoded
Параметры отправляются POST-запросом в формате form-encoded; JSON-тела также принимаются. Кроме стандартных HTTP-библиотек ничего не требуется.
Ответы в JSON
Каждый запрос возвращает JSON. Ошибки приходят в виде единственного поля error, что делает обработку ошибок простой и предсказуемой.
Аутентификация по ключу
Единственный параметр key заменяет всю аутентификацию; не нужно реализовывать подписи, токены или OAuth.
POST https://panelfollows.com/api/v2
Content-Type: application/x-www-form-urlencoded
key=API_KEY&action=balance
# Ответ
{ "balance": "25.4300", "currency": "USD" }Как заказы движутся внутри панели, описано на странице о принципах работы, а модель реселлинга разобрана на странице SMM-панели для реселлеров.
Поддерживаемые действия
Сейчас API поддерживает 7 действий. Все запросы идут на один и тот же endpoint; операция выбирается параметром action.
services
key, action
Возвращает каталог активных услуг: ID услуги, название, категорию, цену за 1000, минимальное и максимальное количество, а также флаги refill, cancel и dripfeed.
add
key, action, service, link, quantity [, runs, interval]
Создает новый заказ и возвращает его номер. Для услуг с dripfeed используйте параметры runs и interval, для услуг с пользовательскими комментариями параметр comments.
status
key, action, order | orders
Возвращает детали заказа: стоимость, стартовое количество, статус и остаток. Передайте список через запятую в параметре orders, чтобы проверить несколько заказов сразу.
balance
key, action
Возвращает баланс вашего аккаунта в USD. Стоимость заказов рассчитывается в той же валюте.
refill
key, action, order | orders
Открывает запрос на рефилл для завершенных заказов в услугах с поддержкой рефилла и возвращает ID рефилла для отслеживания. Несколько заказов можно отправить через запятую.
refill_status
key, action, refill | refills
Возвращает текущее состояние ваших запросов на рефилл. Запрашивайте несколько сразу через параметр refills.
cancel
key, action, orders
Отменяет ожидающие или выполняющиеся заказы и возвращает стоимость на ваш баланс. Принимает несколько номеров заказов через запятую.
Статусы заказов возвращаются как Pending, In progress, Completed, Partial или Canceled.
Хотите готовую витрину вместо интеграции API в собственный софт? Загляните на страницу дочерней панели.
Примеры кода
Примеры ниже используют curl; просто замените API_KEY на ключ, сгенерированный в панели.
Получение списка услуг
# Получить список услуг
curl -X POST https://panelfollows.com/api/v2 \
-d "key=API_KEY" \
-d "action=services"
# Ответ
[
{
"service": "1201",
"name": "Instagram Followers",
"type": "Default",
"category": "Instagram",
"rate": "1.2000",
"min": "10",
"max": "100000",
"refill": true,
"cancel": true,
"dripfeed": false
}
]Создание заказа
# Создать новый заказ
curl -X POST https://panelfollows.com/api/v2 \
-d "key=API_KEY" \
-d "action=add" \
-d "service=1201" \
-d "link=https://instagram.com/username" \
-d "quantity=1000"
# Ответ
{ "order": 23501 }С чего начать?
- 1
Создайте бесплатный аккаунт
Зарегистрируйтесь по электронной почте за считанные секунды. Доступ к API входит в каждый аккаунт без дополнительной платы.
- 2
Сгенерируйте API-ключ
Создайте и скопируйте ключ в один клик на странице API в панели. Ключ можно перевыпустить в любой момент.
- 3
Интегрируйте
Укажите в своем софте endpoint и ключ, получите список услуг и создайте первый заказ через API.
Создавайте свой ключ и управляйте им на странице API в личном кабинете.
Берегите свой API-ключ
Ваш API-ключ может создавать заказы от имени вашего аккаунта, поэтому относитесь к нему как к паролю. Используйте его только на серверной стороне и не допускайте попадания в публичные репозитории, клиентский код и скриншоты.
Если вы подозреваете, что ключ утек, перевыпустите его в один клик на странице API в панели; старый ключ сразу станет недействительным. Кроме того, для защиты от злоупотреблений API ограничен 240 запросами в минуту на каждый ключ.
Часто задаваемые вопросы
API SMM-панели бесплатный?
Да. Доступ к API входит в каждый аккаунт PanelFollows; дополнительной платы или отдельного тарифа нет. Вы платите только стоимость размещаемых заказов.
В каком формате приходят ответы?
Каждое действие возвращает JSON. Баланс и стоимость заказов указываются в USD, а ошибки приходят в виде единственного поля error, поэтому обрабатывать их просто.
Совместим ли он с моим текущим скриптом панели?
Да. API использует стандартный формат реселлера, принятый в отрасли, поэтому в большинстве готовых панельных программ и скриптов достаточно обновить только URL API и ваш ключ.
Есть ли лимит запросов?
Да. На один API-ключ принимается до 240 запросов в минуту; запросы сверх лимита отклоняются с JSON-сообщением об ошибке. Этого более чем достаточно для типичных задач автоматизации.
Поддерживаются ли dripfeed и рефилл через API?
Да. В услугах с dripfeed вы можете добавить параметры runs и interval к действию add. В услугах с поддержкой рефилла откройте запрос действием refill и отслеживайте его через refill_status.
Отзывы клиентов
Реальный опыт тех, кто пользуется этой услугой, их собственными словами.
Twitter
Дмитрий С.
API работает без сбоев
Подключил каталог к своей панели примерно за час. Три недели гоняю около 60 заказов в сутки, ни одного упавшего запроса не было.
Аида Н.
Первый заказ прошёл спокойно
Раньше просмотры не покупала и боялась нажать не туда. Скопировала ссылку на ролик, поставила 5000 и оплатила. Через полтора часа цифра под видео была совсем другая. Больше я в панель в тот день даже не заходила.
Ольга В.
Массовый заказ спас день
Загрузила 28 строк в формате идУслуги|ссылка|количество, прошли все до одной. Раньше на это уходил час кликов.
Павел Ю.
Поднял свою панель за вечер
Сделал панель под своим брендом поверх этой. Прописал A запись в DNS, сертификат выпустился при первом заходе, деньги принимаю через свой шлюз.
Маргарита В.
Лайки страницы без просадок
Страница компании выглядела пустой, поставила 2 400 лайков. Закрылось за одиннадцать часов, за месяц ушло человек пятнадцать. Для Facebook это лучше, чем я ожидала.
Начните автоматизацию с API уже сегодня
Создайте бесплатный аккаунт, получите API-ключ и разместите первый заказ из собственного софта за несколько минут.
Связанные страницы