Asosiy qismga o'tish
Developer API

FineSMM API v2

O'z panelingiz, botingiz yoki saytingizni FineSMM xizmatlariga ulang: xizmatlar ro'yxatini oling, buyurtma bering, holatini va balansni kuzating. Standart SMM panel formati — mavjud skriptlar bilan to'g'ridan-to'g'ri ishlaydi.

JSON javoblar GET yoki POST API kalit orqali Narxlar so'mda (UZS)

Kirish

Barcha so'rovlar bitta manzilga yuboriladi. Parametrlar query-satr (GET) yoki forma (POST, application/x-www-form-urlencoded) ko'rinishida beriladi, qaysi amal bajarilishi action parametri bilan tanlanadi.

GETPOSThttps://finesmm.uz/api/v2
API kalitni qanday olish mumkin? @FineSMMBot botida /business buyrug'ini yuboring — kalit bepul. Kalitni hech kimga bermang; kerak bo'lsa o'sha bo'limda yangilang (eski kalit darhol ishlamay qoladi).

Buyurtma narxi balansingizdan darhol yechiladi: rate / 1000 × quantity. Provayder buyurtmani qabul qilmasa — pul avtomatik qaytariladi. Bekor qilingan yoki qisman bajarilgan buyurtmalar uchun bajarilmagan qism summasi ham balansga qaytadi.

Xizmatlar ro'yxati

Buyurtma berish mumkin bo'lgan barcha xizmatlar: narx (1000 tasi uchun, so'mda), minimal va maksimal miqdor, turi.

GETPOSThttps://finesmm.uz/api/v2
ParametrTavsif
keymajburiySizning API kalitingiz (botda «Business» bo'limi)
actionmajburiyservices
Javob namunasi · JSON
[
    {
        "service": "121",
        "category": "Instagram Video koʻrish",
        "name": "Video koʻrish",
        "rate": "40.51",
        "min": "100",
        "max": "20000000",
        "type": "Default",
        "refill": "false",
        "cancel": "true",
        "dripfeed": "false"
    },
    {
        "service": "245",
        "category": "Instagram Video koʻrish",
        "name": "Video koʻrish (Beta)",
        "rate": "28.36",
        "min": "100",
        "max": "1000000",
        "type": "Default",
        "refill": "false",
        "cancel": "false",
        "dripfeed": "false"
    }
]
rate — 1000 dona uchun narx. refill / cancel — xizmatda qayta tiklash va bekor qilish (bot orqali) mavjudligi.

Buyurtma berish

Yangi buyurtma yaratadi. Kerakli parametrlar xizmat turiga (type) bog'liq.

GETPOSThttps://finesmm.uz/api/v2
ParametrTavsif
keymajburiySizning API kalitingiz (botda «Business» bo'limi)
actionmajburiyadd
servicemajburiyXizmat ID raqami (services ro'yxatidan)
linkmajburiyProfil, kanal yoki post havolasi. So'rovnoma ovozi xizmatlari uchun — javob variantining havolasi: https://t.me/FineSMM/123?option=MQ
quantitymajburiyMiqdor — xizmatning min va max oralig'ida
Javob namunasi · JSON
{
    "order": 35141
}
Havola ochiq bo'lishi kerak: maxfiy profil, o'chirilgan post yoki xato username bo'lsa xizmat bajarilmasligi mumkin (shartlar, 4.4-band).

Buyurtma holati

Bitta buyurtma (order) yoki bir nechtasi (orders, vergul bilan, ko'pi bilan 100 ta) holatini qaytaradi. charge — siz haqiqatda to'lagan summa: bekor qilingan yoki qisman bajarilgan buyurtmada qaytarilgan pul chegirib ko'rsatiladi.

GETPOSThttps://finesmm.uz/api/v2
ParametrTavsif
keymajburiySizning API kalitingiz (botda «Business» bo'limi)
actionmajburiystatus
orderixtiyoriyBuyurtma ID raqami
ordersixtiyoriyBir nechta ID: 101,102,103 (order o'rniga)
Javob namunasi · JSON
{
    "order": "35141",
    "status": "In progress",
    "start_count": "1520",
    "remains": "340",
    "charge": "22.00",
    "currency": "UZS"
}
HolatMa'nosi
PendingNavbatda — tez orada boshlanadi
In progressBajarilmoqda
ProcessingProvayder tomonidan qayta ishlanmoqda
CompletedTo'liq bajarildi
PartialQisman bajarildi — qolgan qism (remains) puli balansga qaytariladi
CanceledBekor qilindi — to'langan summa balansga qaytariladi

Qayta tiklash

Kafolatli (refill: true) xizmatning to'liq bajarilgan buyurtmasida miqdor kamaygan bo'lsa — qayta to'ldirish so'rovi. Kafolat muddati xizmat nomida ko'rsatiladi (masalan, ♻️R30 — 30 kun). Bitta buyurtmaga bir vaqtda bitta so'rov.

GETPOSThttps://finesmm.uz/api/v2
ParametrTavsif
keymajburiySizning API kalitingiz (botda «Business» bo'limi)
actionmajburiyrefill
ordermajburiyBuyurtma ID raqami
Javob namunasi · JSON
{
    "refill": "128"
}

So'rov holati: action=refill_status va refill (yoki bir nechtasi — refills=1,2,3).

ParametrTavsif
keymajburiySizning API kalitingiz (botda «Business» bo'limi)
actionmajburiyrefill_status
refillixtiyoriyQayta tiklash ID raqami
refillsixtiyoriyBir nechta ID, vergul bilan (refill o'rniga)
Javob namunasi · JSON
{
    "status": "Completed"
}
HolatMa'nosi
Pending / In progressQayta tiklanmoqda
CompletedKamaygan miqdor qayta to'ldirildi
RejectedRad etildi (odatda miqdor kamaymagan yoki muddat tugagan)

Bekor qilish

Bekor qilish imkoni bor (cancel: true) xizmatning hali bajarilayotgan buyurtmalarini bekor qilish. Tasdiqlangach buyurtma Canceled yoki Partial bo'ladi va bajarilmagan qism puli balansingizga avtomatik qaytadi.

GETPOSThttps://finesmm.uz/api/v2
ParametrTavsif
keymajburiySizning API kalitingiz (botda «Business» bo'limi)
actionmajburiycancel
ordersmajburiyBuyurtma ID lari, vergul bilan (ko'pi bilan 100 ta)
Javob namunasi · JSON
[
    {
        "order": 35141,
        "cancel": 1
    },
    {
        "order": 35142,
        "cancel": {
            "error": "Cancel is disabled for this order"
        }
    }
]

Buyurtmalarim

Hisobingizdagi barcha buyurtmalar ro'yxati (bot va API orqali berilganlar).

GETPOSThttps://finesmm.uz/api/v2
ParametrTavsif
keymajburiySizning API kalitingiz (botda «Business» bo'limi)
actionmajburiyorders
Javob namunasi · JSON
{
    "orders_count": 2,
    "orders": [
        {
            "customer": "123456789",
            "service": "121",
            "order": "35141",
            "status": "Completed",
            "charge": "22.00",
            "currency": "UZS"
        },
        {
            "customer": "123456789",
            "service": "121",
            "order": "35142",
            "status": "Pending",
            "charge": "44.00",
            "currency": "UZS"
        }
    ]
}

Balans

Hisobingizdagi joriy balans.

GETPOSThttps://finesmm.uz/api/v2
ParametrTavsif
keymajburiySizning API kalitingiz (botda «Business» bo'limi)
actionmajburiybalance
Javob namunasi · JSON
{
    "balance": "78869",
    "currency": "UZS"
}

Xatolar

Xato bo'lganda javob {"error": "..."} ko'rinishida qaytadi — pul yechilmaydi (yoki darhol qaytariladi).

Xato matniSababi
Invalid API keyKalit noto'g'ri yoki yangilangan (eski kalit)
Incorrect service IDBunday xizmat yo'q
Disabled service IDXizmat yoki bo'lim vaqtincha o'chirilgan
To order this service, just login to the botBu xizmat faqat bot orqali buyurtma qilinadi
Bad linkHavola bo'sh, juda uzun yoki bo'sh joy / taqiqlangan belgilar bor
Bad link: poll option link requiredPoll xizmati uchun variant havolasi (?option=…) emas, oddiy post havolasi yuborilgan
Bad answer_numberVariant raqamini havoladan aniqlab bo'lmadi — answer_number yuboring
Quantity less than minimal NMiqdor xizmatning minimalidan kam
Quantity more than maximum NMiqdor xizmatning maksimalidan ko'p
Not enough funds on balanceBalans yetarli emas — botda hisobni to'ldiring
Service temporarily unavailableXizmat vaqtincha ishlamayapti
Incorrect order IDBuyurtma topilmadi yoki sizga tegishli emas
Incorrect requestaction noma'lum yoki berilmagan

Provayder buyurtmani rad etsa, uning xato matni o'zgarishsiz qaytariladi (masalan, shu havolaga faol buyurtma bo'lsa).

Kod misollari

Buyurtma berish va holatini tekshirish — eng ko'p ishlatiladigan tillarda.

Terminal
# Buyurtma berish
curl https://finesmm.uz/api/v2 \
  -d key=SIZNING_API_KALIT \
  -d action=add \
  -d service=121 \
  -d link=https://t.me/kanalim \
  -d quantity=100

# Holatini tekshirish
curl "https://finesmm.uz/api/v2?key=SIZNING_API_KALIT&action=status&order=35141"
API kalitni faqat serveringizda saqlang — brauzer yoki mobil ilova kodiga qo'shmang.

API kalitingizni oling

Botga /business yozing — kalit bepul va darhol beriladi.