FoydaADS

Mijozlar API (v2)

Dasturchilar uchun — o‘z panelingiz, botingiz yoki saytingizni ulang.

Kirish

Barcha so‘rovlar bitta manzilga POST (form yoki JSON) bilan yuboriladi. Qaysi amal bajarilishini action parametri belgilaydi. Javoblar har doim JSON; xato bo‘lsa {"error": "…"}.

Manzil
https://foydaads.uz/api/v2
Metod
POST
Format
JSON

Tez boshlash

  1. 1Saytga kiring va Profil → API kalit bo‘limida kalit yarating.
  2. 2Balansni to‘ldiring — buyurtmalar shu balansdan yechiladi.
  3. 3services bilan xizmat ID'sini oling, add bilan buyurtma bering, status bilan kuzating.
POST/api/v2

Buyurtma berish

Barcha narxlar so‘mda (UZS). Nakrutka narxi (rate) 1000 dona uchun, raqam/Stars/Premium — bitta uchun.

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
Javob
{ "order": 23501 }
POSTaction=services

Barcha faol xizmatlar, narxlari va limitlari.

Parametrlar

key
stringmajburiy
API kalitingiz
action
stringmajburiy
services
curl -X POST https://foydaads.uz/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=services
Javob
[
  {
    "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

Yangi buyurtma yaratadi. Pul balansingizdan yechiladi.

Parametrlar

key
stringmajburiy
API kalitingiz
action
stringmajburiy
add
service
integermajburiy
Xizmat ID (services dan)
link
stringmajburiy
Kanal/post havolasi. Stars va Premium uchun — qabul qiluvchining @username’i
quantity
integermajburiy
Miqdor (min–max oralig‘ida)
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
Javob
{ "order": 23501 }
POSTaction=status

Bitta buyurtma holati.

Raqam buyurtmasida status javobiga phone, code va password maydonlari qo‘shiladi.

Parametrlar

key
stringmajburiy
API kalitingiz
action
stringmajburiy
status
order
integermajburiy
Buyurtma ID
curl -X POST https://foydaads.uz/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=status \
  -d order=23501
Javob
{
  "charge": "9900",
  "start_count": "3572",
  "status": "Partial",
  "remains": "157",
  "currency": "UZS"
}
POSTaction=status

Bir nechta buyurtma holati

100 tagacha buyurtma — vergul bilan.

Parametrlar

key
stringmajburiy
API kalitingiz
action
stringmajburiy
status
orders
stringmajburiy
Buyurtma ID’lari, vergul bilan (100 tagacha)
curl -X POST https://foydaads.uz/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=status \
  -d orders=23501,23502
Javob
{
  "23501": { "charge": "9900", "start_count": "3572", "status": "Completed", "remains": "0", "currency": "UZS" },
  "23502": { "error": "Incorrect order ID" }
}
POSTaction=refill

Kafolatli xizmatlarda tushib ketganlarni qayta to‘ldirish.

Parametrlar

key
stringmajburiy
API kalitingiz
action
stringmajburiy
refill
order
integermajburiy
Buyurtma ID
curl -X POST https://foydaads.uz/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=refill \
  -d order=23501
Javob
{ "refill": "1" }
POSTaction=refill_status

Qayta to‘ldirish holati

refill amalidan olingan ID bo‘yicha.

Parametrlar

key
stringmajburiy
API kalitingiz
action
stringmajburiy
refill_status
refill
stringmajburiy
Refill ID
curl -X POST https://foydaads.uz/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=refill_status \
  -d refill=1
Javob
{ "status": "Completed" }
POSTaction=cancel

Kod kelmagan raqamni bekor qilish (pul qaytadi).

Parametrlar

key
stringmajburiy
API kalitingiz
action
stringmajburiy
cancel
orders
stringmajburiy
Buyurtma ID’lari, vergul bilan (100 tagacha)
curl -X POST https://foydaads.uz/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=cancel \
  -d orders=23510
Javob
[
  { "order": 23510, "cancel": 1 },
  { "order": 9, "cancel": { "error": "Incorrect order ID" } }
]
POSTaction=balance

Joriy balansingiz.

Parametrlar

key
stringmajburiy
API kalitingiz
action
stringmajburiy
balance
curl -X POST https://foydaads.uz/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=balance
Javob
{ "balance": "100840.5", "currency": "UZS" }

Xizmatlar va ID'lar

Saytdagi faol xizmatlar — add amalida service parametriga shu ID beriladi. Narx: nakrutka uchun 1000 dona, qolganlari bitta uchun.

IDNomiNarxMin – max
…

Buyurtma holatlari

Pending
Qabul qilindi, navbatda
Processing
Provayderga yuborildi / raqam SMS kutmoqda
In progress
Bajarilmoqda
Completed
Bajarildi
Partial
Qisman bajarildi — remains qismining puli balansga qaytdi
Canceled
Bekor qilindi — pul balansga qaytdi

Xatolar

Xato bo‘lsa HTTP 200 bilan {"error": "…"} qaytadi (standart SMM panellar kabi). Matnlar ingliz tilida — kodingizda shu bo‘yicha tekshiring.

Invalid API key
Kalit yo‘q yoki noto‘g‘ri
Incorrect request
Noma’lum action yoki buzilgan so‘rov
Incorrect service ID
Bunday faol xizmat yo‘q
Incorrect quantity
Miqdor son emas
Incorrect order ID
Buyurtma topilmadi yoki sizniki emas
Not enough funds on balance
Balans yetarli emas
Account is blocked
Hisob bloklangan
API is temporarily disabled
API vaqtincha o‘chirilgan
Too many requests
Limit: bitta kalitga daqiqasiga 600 so‘rov