Base URL
https://bot.royalemc.qzz.io/api
Balansni ko'rish
GET
/api?key={api_key}&action=getBalance
key
API kalitingiz
majburiy
action
Amal turi: getBalance
majburiy
{
"ok": true,
"balance": {
"value": "15000",
"currency": "UZS"
}
}
Davlatlar ro'yxati
GET
/api?key={api_key}&action=getCountries
key
API kalitingiz
majburiy
action
Amal turi: getCountries
majburiy
[
{
"name": "Uzbekistan 馃嚭馃嚳",
"price": 13500,
"count": "64",
"code": "UZ"
},
{
"name": "T眉rkiye 馃嚬馃嚪",
"price": 16875,
"count": "21",
"code": "TR"
}
]
Nomer olish
GET
/api?key={api_key}&action=getNumber&country=uz
key
API kalitingiz
majburiy
action
Amal turi: getNumber
majburiy
country
Davlat kodi (uz, tr, us...)
majburiy
{
"ok": true,
"data": {
"number": "+998901234567",
"order_id": 154
},
"country": {
"code": "UZ",
"name": "Uzbekistan 馃嚭馃嚳"
},
"meta": {
"price_uzs": 13500
}
}
SMS kod olish
GET
/api?key={api_key}&action=getCode&order_id=154
Kod hali kelmagan bo'lsa, status "pending" bo'ladi. Kod kelguncha so'rovni takrorlash tavsiya etiladi.
key
API kalitingiz
majburiy
action
Amal turi: getCode
majburiy
order_id
getNumber dan olingan ID
majburiy
// Kod kelgan holat:
{
"ok": true,
"data": {
"status": "completed",
"number": "+998901234567",
"sms_code": "47607",
"password": "2345GD8R"
}
}
// Kod kutilayotgan holat:
{
"ok": true,
"data": {
"status": "pending"
}
}
Barcha parametrlar
key
API kalit (barcha so'rovlarda majburiy)
Hamma uchun
action
getBalance / getCountries / getNumber / getCode
Hamma uchun
country
Davlat kodi (faqat getNumber da)
getNumber
order_id
Buyurtma ID (faqat getCode da)
getCode
Har bir muvaffaqiyatli javobda ok: true bo'ladi. Xatolik bo'lsa ok: false va message maydoni qaytadi.