SocGrow Partner API
v2 · Operational

Partner API hujjatlari

SMM xizmatlari va Telegram Stars'ni hamkor panelingizga ulash uchun yagona REST interfeys. Bitta kalit — barcha xizmatlar.

Base URL  https://socgrow.uz/api/v2

Autentifikatsiya

Har bir so'rovda key parametri orqali API kalitingiz yuboriladi. Kalitni botdagi Hamkorlik va API markazi → API Kalit bo'limidan olasiz.

Bitta kalit — barcha xizmatlar uchun. SMM va Stars buyurtmalari bir xil key qiymatidan foydalanadi, alohida ro'yxatdan o'tish shart emas.

Endpointlar

Barcha so'rovlar GET yoki POST orqali qabul qilinadi.

GET
action=balance
Joriy balansni ko'rsatadi
key
GET
action=services
Mavjud xizmatlar ro'yxati — narx, min/max, tur
key
POST
action=add
Yangi buyurtma yaratadi (SMM, Stars yoki Nomer)
key service link quantity
GET
action=status
Buyurtma holatini tekshiradi (Nomer uchun SMS kodni ham qaytaradi)
key order / orders
GET
action=orders
Buyurtmalar tarixi
key

Telegram Stars

action=add chaqirilganda service parametriga Stars xizmatining ID raqami beriladi; link maydoniga havola o'rniga qabul qiluvchi Telegram username yoziladi.

Request
POST /api/v2?action=add&service=239&link=username&quantity=50&key=SIZNING_KALIT
Response · 200
{
  "order": 1042,
  "charge": 10500,
  "currency": "UZS"
}
ParametrTavsif
serviceshartStars xizmati ID — action=services orqali olinadi
linkshartQabul qiluvchi Telegram @username
quantityshartStars miqdori — min 50, max 100 000

order — boshqa xizmatlar kabi oddiy raqam, action=status orqali tekshirish mumkin.

Nomer (Virtual raqam)

action=add chaqirilganda service parametriga Nomer xizmatining ID raqami beriladi; link maydoniga havola o'rniga davlat kodi yoziladi. Narx davlatga qarab dinamik hisoblanadi.

Davlat kodlarini bilmayapsizmi? link maydonini bo'sh yoki noto'g'ri qiymat bilan yuborsangiz, javobda barcha mavjud davlatlar kodi, nomi va narxi (countries massivi) qaytadi.
Request
POST /api/v2?action=add&service=248&link=7&key=SIZNING_KALIT
Response · 200
{
  "order": "NUM-58",
  "charge": 8200,
  "currency": "UZS"
}
ParametrTavsif
serviceshartNomer xizmati ID — action=services orqali olinadi (type:"nomer")
linkshartDavlat kodi — noto'g'ri bo'lsa, xatolik bilan birga countries ro'yxati qaytadi

Raqam darhol qaytadi, ammo SMS kod biroz kechikishi mumkin — shuning uchun action=status orqali order qiymatini (masalan NUM-58) pollash kerak.

Request
GET /api/v2?action=status&order=NUM-58&key=SIZNING_KALIT
Response · 200
{
  "order": "NUM-58",
  "status": "Completed",
  "phone": "+79991234567",
  "country": "Russia",
  "code": "48291",
  "password": "",
  "charge": 8200,
  "currency": "UZS"
}

SMM buyurtma

Ijtimoiy tarmoq xizmatlari uchun link maydoniga manzil (URL) yoziladi.

Request
POST /api/v2?action=add&service=229&link=https://t.me/kanal&quantity=1000&key=SIZNING_KALIT
Response · 200
{ "order": 1042, "charge": 1692600, "currency": "UZS" }

Balans tekshirish

Request
GET /api/v2?action=balance&key=SIZNING_KALIT
Response · 200
{ "balance": "125000.00", "currency": "UZS" }

Xatoliklar

Muvaffaqiyatsiz so'rovlar har doim error maydoni bilan qaytadi, HTTP status 200:

Error response
{ "error": "Minimum miqdor: 50" }

Yordam

Integratsiya bo'yicha savollar bo'lsa, botdagi Hamkorlik va API markazi → Texnik yordam tugmasi orqali murojaat qiling.