Nickname va regionni bir so'rovda oling

1Tezkor boshlash

Birinchi so'rov:

curl -H "Authorization: Bearer mlbb_SIZNING_TOKENINGIZ" \
  "https://mlbb.nurali.uz/v1/check?id=1290132154&zone=15246"

{
  "ok": true,
  "account_id": "1290132154",
  "zone_id": "15246",
  "nickname": "Ｗａｄｅｒ〆",
  "region": "Uzbekistan",
  "server_type": "Original Server"
}

2Token olish

API faqat token bilan ishlaydi. Token admin tomonidan beriladi.

1. Telegram orqali @vafoyev_n ga yozing: loyihangiz nomi va kutilayotgan so'rovlar sonini ayting.
2. Sizga mlbb_ bilan boshlanadigan token beriladi. U faqat bir marta ko'rsatiladi — xavfsiz joyda saqlang.
3. Har bir so'rovda tokenni Authorization sarlavhasida yuboring.

3Sinab ko'rish

So'rov to'g'ridan-to'g'ri brauzeringizdan API'ga yuboriladi. Token faqat shu sahifada qoladi (belgilasangiz — brauzer yopilguncha).

4Autentifikatsiya

Token uch usulda qabul qilinadi (birinchisi tavsiya etiladi):

5GET /v1/check

Akkaunt nickname'i va regionini qaytaradi. Ikki xil yozilishi bor:

Parametrlar

Holat so'rovi

GET /v1 — token talab qilmaydi; servis ishlayotganini va limitni qaytaradi. Monitoring uchun qulay.

6Javob maydonlari

Xato bo'lganda: {"ok": false, "error": "kod", "message": "izoh"}. Dasturda error kodiga tayaning — message matni o'zgarishi mumkin.

7Xato kodlari

8Javob sarlavhalari

9Limitlar

• Limit token boshiga hisoblanadi va har 60 soniyada yangilanadi. Keshdan qaytgan javoblar ham hisobga kiradi.
• Limitdan oshsa — 429 rate_limited va Retry-After: 60 qaytadi. Bu vaqtda yuborilgan so'rovlar ham rad etiladi, shuning uchun to'xtab turing.
• Limit Cloudflare tarmog'ining har bir hududida alohida hisoblanadi, shuning uchun chegara atrofida bir oz farq bo'lishi mumkin — 60 ga yaqin ishlamang, o'z tomoningizda navbat (queue) qiling.
• Ko'proq kerak bo'lsa (masalan, ommaviy tekshiruv) — Telegram orqali @vafoyev_n ga yozing.

10Qayta yuborish (retry) qoidalari

• So'rov uchun 8–10 soniya timeout qo'ying.
• Bir xil id + zone ni bir vaqtda qayta-qayta yubormang — bitta javobni kuting.
• Foydalanuvchi kiritayotgan har bir harf uchun emas, faqat "Tekshirish" bosilganda so'rov yuboring.

async function checkMlbb(id, zone) {
  for (let attempt = 0; attempt < 4; attempt++) {
    let res;
    try {
      res = await fetch(`https://mlbb.nurali.uz/v1/check?id=${id}&zone=${zone}`, {
        headers: { Authorization: `Bearer ${process.env.MLBB_API_TOKEN}` },
        signal: AbortSignal.timeout(10_000),
      });
    } catch {
      res = null; // tarmoq xatosi / timeout
    }

    if (res && res.status < 500 && res.status !== 429) return res.json(); // 2xx/4xx — qayta yubormaymiz
    if (attempt === 3) break;

    const wait = res?.status === 429
      ? Number(res.headers.get("retry-after") || 60) * 1000
      : 1000 * 2 ** attempt + Math.random() * 500;
    await new Promise((r) => setTimeout(r, wait));
  }
  throw new Error("MLBB API vaqtincha ishlamayapti");
}

11Kesh — nega tez

API Cloudflare tarmog'ida, sizga eng yaqin serverda ishlaydi. Javob uch qavatdan qidiriladi:

• Topilgan nickname 30 daqiqa keshda saqlanadi. O'yinchi nickname'ini o'zgartirsa, yangisi 30 daqiqagacha kechikib ko'rinadi.
• "Topilmadi" (404) javobi 2 daqiqa saqlanadi.
• Manba servis ishlamay qolsa, 24 soatgacha oxirgi ma'lum javob qaytariladi (X-Cache: STALE).
• Bir vaqtda kelgan bir xil so'rovlar manbaga bitta murojaat sifatida boradi.

12Xavfsizlik

• Tokenni muhit o'zgaruvchisida saqlang (MLBB_API_TOKEN), git'ga qo'shmang.
• Faqat HTTPS orqali ishlaydi.
• Token oshkor bo'lsa — darhol @vafoyev_n ga yozing; u bekor qilinadi (1 daqiqa ichida kuchga kiradi) va yangisi beriladi.

13OpenAPI (JSON)

API'ning to'liq mashina o'qiy oladigan tavsifi — OpenAPI 3.1. Uni Postman, Insomnia, Swagger yoki kod generatorlariga (openapi-generator, orval) import qiling.

Yuklanmoqda…

14Kod namunalari

curl -sS \
  -H "Authorization: Bearer $MLBB_API_TOKEN" \
  "https://mlbb.nurali.uz/v1/check/1290132154/15246"

const res = await fetch("https://mlbb.nurali.uz/v1/check?id=1290132154&zone=15246", {
  headers: { Authorization: `Bearer ${process.env.MLBB_API_TOKEN}` },
});
const data = await res.json();

if (data.ok) console.log(data.nickname, data.region);
else console.error(res.status, data.error);

import os, requests

r = requests.get(
    "https://mlbb.nurali.uz/v1/check",
    params={"id": "1290132154", "zone": "15246"},
    headers={"Authorization": f"Bearer {os.environ['MLBB_API_TOKEN']}"},
    timeout=10,
)
data = r.json()
if data["ok"]:
    print(data["nickname"], data["region"])
else:
    print(r.status_code, data["error"])

<?php
$ch = curl_init("https://mlbb.nurali.uz/v1/check?id=1290132154&zone=15246");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 10,
    CURLOPT_HTTPHEADER     => ["Authorization: Bearer " . getenv("MLBB_API_TOKEN")],
]);
$data = json_decode(curl_exec($ch), true);
$code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($data["ok"]) {
    echo $data["nickname"] . " — " . $data["region"];
} else {
    echo $code . " " . $data["error"];
}

15Aloqa