PARTNER API

Partner API
Documentation

Virtual raqam xizmatlarini hamkor panelingizga ulash uchun yagona REST interfeys. Bitta kalit — barcha xizmatlar.

BASE URL
https://sans.uz/api

Authentication

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

Bitta kalit — barcha so'rovlar uchun. Alohida ro'yxatdan o'tish shart emas.

Endpoints

Barcha so'rovlar GET yoki POST orqali qabul qilinadi.

GET action=balance Joriy balansni ko'rsatadi POST action=add Yangi raqam xarid qiladi GET action=status Buyurtma holatini va SMS kodni tekshiradi

Virtual Number

action=add chaqirilganda service parametriga xizmatning istalgan ID raqami berilishi mumkin (bizda yagona virtual raqam xizmati); link maydoniga davlat kodi yoziladi. Narx davlatga qarab dinamik hisoblanadi va balansingizdan yechiladi.

INFO

Davlat kodlarini bilmayapsizmi? link maydonini bo'sh yoki noto'g'ri qiymat bilan yuborsangiz, javobda barcha mavjud davlatlar kodi, nomi va narxi (countries massivi) hamda xatolik qaytadi.

Request 
POST /api?action=add&service=1&link=UZ&key=SIZNING_KALIT
Response · 200 
{
  "order": "NUM-998901234567",
  "charge": 8200,
  "currency": "UZS"
}

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

Order Status

Sotib olingan raqamga kelgan SMS kodni olish uchun ushbu zaprosdan foydalanasiz.

Request 
GET /api?action=status&order=NUM-998901234567&key=SIZNING_KALIT
Response · 200 (Completed) 
{
  "order": "NUM-998901234567",
  "status": "Completed",
  "phone": "+998901234567",
  "code": "48291",
  "password": "",
  "currency": "UZS"
}
PENDING STATUS

Agar kod hali kelmagan bo'lsa, status maydoni "Pending" bo'ladi va code bo'sh qoladi.

Balance

Joriy hisobingizdagi qoldiqni (balansni) tekshirish uchun ushbu so'rovdan foydalanasiz.

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

Parameters

Parameter Required Description
service Required Xizmat raqami (ixtiyoriy har qanday raqam yuborilishi mumkin, masalan: 1). Tizim avtomatik virtual raqamni hisoblaydi.
link Required Davlat kodi (masalan: UZ, RU, US). Bo'sh bo'lsa ro'yxat qaytadi.
key Required Hamkor API kaliti barcha so'rovlarda yuborilishi shart.
order Required Faqatgina status zaprosida talab qilinadi. Qaytarilgan buyurtma raqami (masalan NUM-998...).

Errors

Muvaffaqiyatsiz so'rovlar har doim error maydoni bilan qaytadi, SMM standartiga muvofiq HTTP status doim 200 bo'ladi:

Error response 
{
  "error": "Hisobingizda yetarli mablag' yo'q"
}

Help

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

Barcha tizimlar normal ishlayapti