API SMM-панели: автоматизация заказов через стандартный API

Если вы заказываете услуги оптом, ведёте собственный магазин или перепродаёте услуги клиентам, вводить каждый заказ вручную неудобно и не масштабируется. API SMM-панели EtkilesimBayim позволяет вашему скрипту или панели автоматически создавать заказы, проверять их статус и отправлять запросы на догонку. Он работает в стандартном формате на основе параметра action, принятом у панелей для реселлеров, поэтому многие существующие скрипты и панельные движки подключаются с минимальными изменениями или вовсе без них.

Адрес и авторизация

Все запросы отправляются на один адрес: https://etkilesimbayim.com/api/v2. Отправляйте запрос методом POST (форма или JSON); для проверки соединения с теми же параметрами работает и GET. В каждом запросе нужны два параметра: key (ваш API-ключ) и action. API-ключ вы получаете на странице аккаунта после регистрации. Ответы всегда приходят в формате JSON.

Поддерживаемые действия

Action	Что делает	Параметры
services	Возвращает список всех активных и видимых услуг: цена за 1000, минимум и максимум, тип и поддержка отмены	нет
add	Создаёт заказ и возвращает его номер	service, link, quantity
status	Возвращает стоимость, начальное значение, статус и остаток по одному или нескольким заказам	order (несколько — через запятую)
refill	Ставит запрос на догонку в очередь на проверку	order или orders (до 100)
refill_status	Возвращает статус запроса на догонку	refill или refills (до 100)
cancel	Создаёт запрос на отмену для услуг, которые её поддерживают	orders (до 100)
balance	Возвращает текущий баланс и валюту	нет

Пример запроса

Создание заказа выглядит так:

POST https://etkilesimbayim.com/api/v2
key=ВАШ_API_КЛЮЧ&action=add&service=1&link=https://instagram.com/example&quantity=1000

Ответ: { "order": 123 }

Статусы заказа, которые возвращает status: Pending, Processing, In progress, Completed, Partial, Canceled и Fail. Запросы на догонку проходят статусы Pending, In progress, Completed или Rejected.

Обработка ошибок

Ошибки приходят с кодом HTTP 200 и телом JSON вида { "error": "Not enough funds" } — именно такого формата ждёт большинство скриптов для реселлеров. Частые сообщения: отсутствующий или неверный ключ, неверный action, недостаточно средств и заказ не найден. Вашему коду стоит проверять поле error в каждом ответе, а не полагаться на HTTP-статус.

Советы по интеграции

• Кэшируйте список услуг. Вызывайте services с интервалом, а не перед каждым заказом; цены и доступность могут меняться, поэтому обновляйте список регулярно.
• Опрашивайте статус разумно. Передавайте несколько номеров заказов через запятую вместо отдельного запроса на каждый. Для каждого API-ключа действуют ограничения частоты запросов, поэтому не опрашивайте без необходимости.
• Обрабатывайте Partial и Fail. При этих статусах запускайте собственный процесс: уведомите клиента или повторите заказ.
• Догонка и отмена — это запросы. Запросы на догонку ставятся в очередь на проверку и не выполняются мгновенно. Отмена работает только для услуг с cancel: true.
• Берегите ключ. Храните его только на стороне сервера, не размещайте в клиентском коде и публичных репозиториях.

Для кого этот API?

Он подходит всем, кто хочет создавать заказы программно: реселлерам, продающим своим клиентам, владельцам панелей и магазинов, а также агентствам, которые автоматизируют регулярные кампании. Если вы сравниваете варианты, прежде чем строить систему на базе поставщика, пригодятся статьи как выбрать SMM-панель и как запустить панель для реселлеров (на английском). Чтобы продавать под своим брендом, откройте страницу панель для реселлеров. Все услуги — в списке услуг и цен, а обзор SMM-панели расскажет об обычном заказе.

Полное описание запросов и ответов — в документации API. Чтобы получить API-ключ, создайте бесплатный аккаунт.