FoydaADS

API клиентов (v2)

Для разработчиков — подключите свою панель, бота или сайт.

Введение

Все запросы отправляются POST (form или JSON) на один адрес. Действие задаёт параметр action. Ответ всегда JSON; при ошибке — {"error": "…"}.

Адрес
https://foydaads.uz/api/v2
Метод
POST
Формат
JSON

Быстрый старт

  1. 1Войдите на сайт и создайте ключ в Профиль → API ключ.
  2. 2Пополните баланс — заказы списываются с него.
  3. 3Получите ID услуги через services, создайте заказ через add, следите через status.
POST/api/v2

Создать заказ

Все цены в сумах (UZS). Цена накрутки (rate) — за 1000 шт, номера/Stars/Premium — за 1 шт.

curl -X POST https://foydaads.uz/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=add \
  -d service=1 \
  -d link=https://t.me/your_channel \
  -d quantity=1000
Ответ
{ "order": 23501 }
POSTaction=services

Все активные услуги, цены и лимиты.

Параметры

key
stringобязательный
Ваш API-ключ
action
stringобязательный
services
curl -X POST https://foydaads.uz/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=services
Ответ
[
  {
    "service": 1,
    "name": "Telegram — kanal obunachilari",
    "type": "Default",
    "category": "Telegram — members",
    "rate": "9900",
    "min": 100,
    "max": 50000,
    "refill": true,
    "cancel": false,
    "dripfeed": false,
    "currency": "UZS"
  }
]
POSTaction=add

Создаёт новый заказ. Сумма списывается с вашего баланса.

Параметры

key
stringобязательный
Ваш API-ключ
action
stringобязательный
add
service
integerобязательный
ID услуги (из services)
link
stringобязательный
Ссылка на канал/пост. Для Stars и Premium — @username получателя
quantity
integerобязательный
Количество (в пределах min–max)
curl -X POST https://foydaads.uz/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=add \
  -d service=1 \
  -d link=https://t.me/your_channel \
  -d quantity=1000
Ответ
{ "order": 23501 }
POSTaction=status

Статус одного заказа.

Для заказа номера в ответ status добавляются поля phone, code и password.

Параметры

key
stringобязательный
Ваш API-ключ
action
stringобязательный
status
order
integerобязательный
ID заказа
curl -X POST https://foydaads.uz/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=status \
  -d order=23501
Ответ
{
  "charge": "9900",
  "start_count": "3572",
  "status": "Partial",
  "remains": "157",
  "currency": "UZS"
}
POSTaction=status

Статус нескольких заказов

До 100 заказов — через запятую.

Параметры

key
stringобязательный
Ваш API-ключ
action
stringобязательный
status
orders
stringобязательный
ID заказов через запятую (до 100)
curl -X POST https://foydaads.uz/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=status \
  -d orders=23501,23502
Ответ
{
  "23501": { "charge": "9900", "start_count": "3572", "status": "Completed", "remains": "0", "currency": "UZS" },
  "23502": { "error": "Incorrect order ID" }
}
POSTaction=refill

Докрутка списаний в услугах с гарантией.

Параметры

key
stringобязательный
Ваш API-ключ
action
stringобязательный
refill
order
integerобязательный
ID заказа
curl -X POST https://foydaads.uz/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=refill \
  -d order=23501
Ответ
{ "refill": "1" }
POSTaction=refill_status

Статус дозаполнения

По ID, полученному из refill.

Параметры

key
stringобязательный
Ваш API-ключ
action
stringобязательный
refill_status
refill
stringобязательный
Refill ID
curl -X POST https://foydaads.uz/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=refill_status \
  -d refill=1
Ответ
{ "status": "Completed" }
POSTaction=cancel

Отмена номера, на который не пришёл код (деньги возвращаются).

Параметры

key
stringобязательный
Ваш API-ключ
action
stringобязательный
cancel
orders
stringобязательный
ID заказов через запятую (до 100)
curl -X POST https://foydaads.uz/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=cancel \
  -d orders=23510
Ответ
[
  { "order": 23510, "cancel": 1 },
  { "order": 9, "cancel": { "error": "Incorrect order ID" } }
]
POSTaction=balance

Ваш текущий баланс.

Параметры

key
stringобязательный
Ваш API-ключ
action
stringобязательный
balance
curl -X POST https://foydaads.uz/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=balance
Ответ
{ "balance": "100840.5", "currency": "UZS" }

Услуги и ID

Активные услуги сайта — этот ID передаётся в параметр service при add. Цена: для накрутки за 1000, остальные за штуку.

IDНазваниеЦенаМин – макс
…

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

Pending
Принят, в очереди
Processing
Передан провайдеру / номер ждёт SMS
In progress
Выполняется
Completed
Выполнен
Partial
Частично — деньги за remains возвращены
Canceled
Отменён — деньги возвращены

Ошибки

При ошибке возвращается HTTP 200 и {"error": "…"} (как у стандартных SMM-панелей). Тексты на английском — проверяйте по ним.

Invalid API key
Ключ отсутствует или неверный
Incorrect request
Неизвестный action или битый запрос
Incorrect service ID
Нет такой активной услуги
Incorrect quantity
Количество не число
Incorrect order ID
Заказ не найден или не ваш
Not enough funds on balance
Недостаточно средств
Account is blocked
Аккаунт заблокирован
API is temporarily disabled
API временно отключён
Too many requests
Лимит: 600 запросов в минуту на ключ