π Hamkorlik API β to'liq qo'llanma
Virtual raqamlarni (Server 1) o'z botingiz, saytingiz yoki dasturingiz orqali avtomatik oling. Pul bizning botdagi balansingizdan so'mda yechiladi.
π Tez boshlash (5 qadam)
sk_β¦) faqat bir marta ko'rsatiladi β darhol nusxalab, xavfsiz joyda saqlang.GET /balance β balansingiz qaytsa, kalit to'g'ri.GET /countries bilan davlat va narxni tanlang, POST /numbers bilan raqam oling.GET /numbers/{id} ni 5β10 soniyada bir so'rab, status = ok bo'lganda code ni oling.https://sinovbot.c4461.orax1.vip/api/v1
Barcha so'rovlar shu manzilga qo'shiladi: masalan https://sinovbot.c4461.orax1.vip/api/v1/balance. Javob har doim JSON.π Kalit (autentifikatsiya)
Kalitni quyidagi usullardan biri bilan yuboring (birinchisi tavsiya etiladi):
| Usul | Misol |
|---|---|
| Sarlavha (tavsiya) | X-Api-Key: sk_β¦ |
| Bearer | Authorization: Bearer sk_β¦ |
| Parametr | ?api_key=sk_β¦ (URL loglarda qolishi mumkin) |
π Ish tartibi
Kod 30 daqiqagacha kutiladi. Shu vaqt ichida kelmasa holat expired bo'ladi.
π‘ So'rovlar
Parametrlarni query (?country=US), form (application/x-www-form-urlencoded) yoki JSON (application/json) ko'rinishida yuborish mumkin. Barcha narxlar so'mda.
/ping β kalitsiz, xizmat ishlayaptimi{"ok": true, "service": "numbers", "version": 1}/balance β balans{"ok": true, "balance": 125400.0, "currency": "UZS"}/countries β davlatlar, narx va mavjud soni (arzonidan boshlab){"ok": true, "currency": "UZS", "countries": [
{"country": "CO", "name": "Colombia", "dial": "57", "price": 4000, "stock": 538},
{"country": "US", "name": "United States", "dial": "1", "price": 4300, "stock": 625}
]}
Narx sizning foizingiz bo'yicha hisoblanadi va kurs o'zgarsa o'zgarishi mumkin β xarid oldidan yangilab turing (β1 daqiqa kesh qilish yetarli).
/numbers β raqam olish (balansdan yechiladi)| Parametr | Majburiy | Izoh |
|---|---|---|
country | ha | 2 harfli ISO kod: US, CO, BD⦠|
max_price | yo'q | So'mda. Narx bundan oshib ketsa xarid qilinmaydi (PRICE_TOO_HIGH). Tavsiya etiladi. |
request_id | yo'q | Sizning buyurtma ID ingiz (1β56 belgi: A-Z a-z 0-9 . _ -). Shu ID bilan qayta yuborilsa pul ikkinchi marta yechilmaydi, avvalgi natija qaytadi ("duplicate": true). Har doim yuboring! |
// 200 β raqam berildi
{"ok": true, "balance": 121100.0, "id": 4521, "status": "wait", "country": "US",
"phone": "+15550142387", "price": 4300, "created_at": "2026-11-17 10:21:05"}
// 202 β raqam holati aniqlanmoqda (tarmoq uzilishi): shu id ni /numbers/{id} bilan so'rang
{"ok": true, "id": 4522, "status": "pending", "phone": null, ...}/numbers/{id} β raqam holati va kod// kod kutilmoqda
{"ok": true, "id": 4521, "status": "wait", "phone": "+15550142387", "expires_in": 1640, ...}
// kod keldi
{"ok": true, "id": 4521, "status": "ok", "phone": "+15550142387", "code": "48213", "password": "β¦", ...}
password β faqat akkauntda 2 bosqichli parol bo'lsa. expires_in β kod kutishning qolgan soniyalari. Provayder 5 soniyada ko'pi bilan bir marta tekshiriladi β tezroq so'rash foyda bermaydi.
/numbers?limit=20 β oxirgi raqamlaringiz (limit β€ 100){"ok": true, "numbers": [{"id": 4521, "status": "ok", "country": "US", "phone": "+1β¦", "price": 4300, "code": "48213", ...}]}π¦ Raqam holatlari
| status | Ma'nosi | Nima qilish kerak |
|---|---|---|
pending | Raqam holati aniqlanmoqda | Kuting, /numbers/{id} ni so'rashda davom eting. Raqam keladi yoki pul qaytadi. |
wait | Raqam berildi, kod kutilmoqda | Raqamni Telegram'ga kiriting, har 5β10 s da so'rang. |
ok | Kod keldi | code (va password) ni ishlating. Tugadi β
|
expired | 30 daqiqada kod kelmadi | Pul qaytmaydi (pastga qarang). So'rashni to'xtating. |
refunded | Pul balansga qaytarilgan | Yangi raqam oling. |
failed | Xato | So'rashni to'xtating, kerak bo'lsa yangi raqam oling. |
β οΈ Xato kodlari
Xato javobi: {"ok": false, "error": "KOD", "message": "tushuntirish"}. Dasturingizda error kodiga qarab ish tuting (message o'zgarishi mumkin).
| error | HTTP | Sabab va yechim |
|---|---|---|
BAD_KEY | 401 | Kalit noto'g'ri yoki eskirgan β yangi kalitni tekshiring. |
DISABLED | 403 | Hamkorlik o'chirilgan β administratorga yozing. |
RATE_LIMIT | 429 | 10 soniyada 30 tadan ko'p so'rov β biroz kuting, so'rovlarni kamaytiring. |
NO_BALANCE | 402 | Balans yetmaydi (javobda balance, price) β botda balansni to'ldiring. |
NO_NUMBERS | 409 | Bu davlatda raqam yo'q β boshqa davlat. refunded: true bo'lsa pul qaytarilgan. |
PRICE_TOO_HIGH | 409 | Narx max_price dan oshdi (javobda price) β narxni yangilab qaror qiling. |
PRICE_CHANGED | 409 | Xarid paytida narx o'zgardi, pul qaytarildi β qayta urinib ko'ring. |
BAD_COUNTRY | 400 | country 2 harfli ISO kod emas. |
BAD_MAX_PRICE | 400 | max_price musbat son emas. |
BAD_REQUEST_ID | 400 | request_id formati noto'g'ri (1β56 belgi, A-Z a-z 0-9 . _ -). |
NOT_FOUND | 404 | Raqam topilmadi yoki sizniki emas / bunday manzil yo'q. |
SERVICE_UNAVAILABLE | 503 | Provayder javob bermayapti β 1β2 daqiqadan so'ng qayta urining. |
INTERNAL | 500 | Ichki xato β qayta urining, takrorlansa administratorga yozing. |
π» Kod namunalari
To'liq jarayon: balans β raqam olish (request_id va max_price bilan) β kodni kutish. KALIT o'rniga o'z kalitingizni qo'ying.
import time, uuid, requests
BASE = "https://sinovbot.c4461.orax1.vip/api/v1"
H = {"X-Api-Key": "KALIT"}
def api(method, path, **kw):
r = requests.request(method, BASE + path, headers=H, timeout=60, **kw)
return r.json()
print(api("GET", "/balance")) # {'ok': True, 'balance': ...}
order_id = "order-" + uuid.uuid4().hex[:12] # o'z buyurtma ID ingiz
res = api("POST", "/numbers", data={"country": "US", "max_price": 6000, "request_id": order_id})
if not res["ok"]:
raise SystemExit(f"Xato: {res['error']} - {res['message']}")
num_id = res["id"]
print("Raqam:", res.get("phone"))
for _ in range(200): # ~30 daqiqa
time.sleep(8)
st = api("GET", f"/numbers/{num_id}")
if st.get("status") == "ok":
print("KOD:", st["code"], "| 2FA:", st.get("password"))
break
if st.get("status") in ("expired", "refunded", "failed"):
print("Tugadi:", st["status"]); break<?php
const BASE = "https://sinovbot.c4461.orax1.vip/api/v1";
const KEY = "KALIT";
function api($method, $path, $params = []) {
$ch = curl_init(BASE . $path);
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 60,
CURLOPT_HTTPHEADER => ["X-Api-Key: " . KEY], CURLOPT_CUSTOMREQUEST => $method]);
if ($method === "POST") curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params));
$res = json_decode(curl_exec($ch), true);
curl_close($ch);
return $res;
}
$res = api("POST", "/numbers", ["country" => "US", "max_price" => 6000,
"request_id" => "order-" . bin2hex(random_bytes(6))]);
if (!$res["ok"]) die("Xato: {$res['error']} - {$res['message']}");
echo "Raqam: {$res['phone']}\n";
for ($i = 0; $i < 200; $i++) {
sleep(8);
$st = api("GET", "/numbers/" . $res["id"]);
if ($st["status"] === "ok") { echo "KOD: {$st['code']}\n"; break; }
if (in_array($st["status"], ["expired", "refunded", "failed"])) { echo "Tugadi: {$st['status']}\n"; break; }
}// Node.js 18+ (fetch o'rnatilgan)
const BASE = "https://sinovbot.c4461.orax1.vip/api/v1";
const H = { "X-Api-Key": "KALIT", "Content-Type": "application/json" };
const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
async function api(method, path, body) {
const r = await fetch(BASE + path, { method, headers: H, body: body ? JSON.stringify(body) : undefined });
return r.json();
}
(async () => {
const res = await api("POST", "/numbers", { country: "US", max_price: 6000,
request_id: "order-" + Date.now() });
if (!res.ok) throw new Error(`${res.error}: ${res.message}`);
console.log("Raqam:", res.phone);
for (let i = 0; i < 200; i++) {
await sleep(8000);
const st = await api("GET", `/numbers/${res.id}`);
if (st.status === "ok") { console.log("KOD:", st.code); break; }
if (["expired", "refunded", "failed"].includes(st.status)) { console.log("Tugadi:", st.status); break; }
}
})();# Balans
curl -H "X-Api-Key: KALIT" https://sinovbot.c4461.orax1.vip/api/v1/balance
# Davlatlar va narxlar
curl -H "X-Api-Key: KALIT" https://sinovbot.c4461.orax1.vip/api/v1/countries
# Raqam olish
curl -H "X-Api-Key: KALIT" -d "country=US" -d "max_price=6000" -d "request_id=order-1001" https://sinovbot.c4461.orax1.vip/api/v1/numbers
# Holat va kod (har 5-10 soniyada)
curl -H "X-Api-Key: KALIT" https://sinovbot.c4461.orax1.vip/api/v1/numbers/4521β To'g'ri ishlatish qoidalari
request_id yuboring. Internet uzilsa yoki javob kelmasa β xuddi shu request_id bilan qayta yuboring: pul ikki marta yechilmaydi, avvalgi raqam qaytadi.max_price qo'ying. Kurs o'zgarsa siz kutmagan narxda xarid bo'lib ketmaydi.RATE_LIMIT ga olib keladi (10 soniyada 30 ta so'rov chegarasi).id ni so'rashda davom eting β raqam keladi yoki pul avtomatik qaytadi.NO_BALANCE kelishidan oldin /balance ni tekshirib, o'z vaqtida to'ldiring.π° Pul qachon yechiladi va qaytadi
| Holat | Pul |
|---|---|
| Raqam berilmadi (NO_NUMBERS, narx o'zgardi, provayder xatosi) | β Darhol avtomatik qaytadi |
pending va raqam oxir-oqibat berilmadi | β
Avtomatik qaytadi (refunded) |
| Raqam berildi, kod keldi | Xarid bajarildi |
Raqam berildi, lekin 30 daqiqada kod kelmadi (expired) | β οΈ Provayder pulni qaytarmaydi. Shuning uchun raqamni olgach darhol ishlating. |
Narx = provayder narxi Γ USD kursi + hamkor foizi, 100 so'mga yaxlitlanadi. Joriy narxlarni har doim /countries dan oling.
π€ Botingiz nusxasi uchun (Moonum formati)
Agar sizda shu botning nusxasi bo'lsa, u bizning API'ga Moonum formatida ulanadi β kodni o'zgartirish shart emas. Nusxa botning .env fayliga:
MOONUM_API_URL=https://sinovbot.c4461.orax1.vip/api/v1/moonum
MOONUM_API_KEY=sk_β¦ (o'z kalitingiz)
Bu formatda narxlar USD da ko'rsatiladi (so'm Γ· bizdagi USD kursi), amallar: getBalance, getCountries, getNumber (country, max_price, request_id), getCode (id). Nusxa botda USD kursini bizdagi bilan bir xil qo'ying.
β Savol-javob
Kalitni yo'qotdim, nima qilay?
Narxlar botdagi narx bilan bir xilmi?
/countries javobida.Javob kelmay qoldi (timeout) β pul yechildimi?
request_id bilan qayta POST /numbers yuboring. Xarid bo'lgan bo'lsa o'sha raqam qaytadi (duplicate: true), bo'lmagan bo'lsa yangi xarid qilinadi. Pul ikki marta yechilmaydi.Kod kelmadi, pulni qaytarib bera olasizmi?
id si bilan administratorga yozing.Bir nechta kalit yoki bot ulasam bo'ladimi?
Balansni API orqali to'ldirsa bo'ladimi?
Xizmat ishlayaptimi β qanday tekshiraman?
GET https://sinovbot.c4461.orax1.vip/api/v1/ping β kalitsiz ishlaydi.Savollar bo'lsa β botdagi Β«π¬ Qo'llab-quvvatlashΒ» orqali yozing.