Qabul qiluvchini qidirish va kesh

GET /v1/recipients/lookup?username=durov&product=PREMIUM&months=3

{ "username": "durov", "found": true, "name": "Pavel Durov", "photoUrl": "https://…", "eligible": true }

• username durov, @Durov yoki https://t.me/durov ko'rinishida qabul qilinadi: biz uni kichik harflarga o'tkazamiz va @ hamda havolani olib tashlaymiz.
• product: STARS (standart) yoki PREMIUM; Premium uchun months (3, 6 yoki 12) majburiy, shu orqali sovg'a qilish mumkinligi tekshiriladi (faol Premium'ga sovg'a qilib bo'lmaydi, javobda eligible: false bo'ladi). Stars uchun eligible found bilan bir xil.
• found: false xato emas, oddiy 200 javob. Noto'g'ri username uchun 400 (-9202), months ko'rsatilmagan Premium uchun ham 400 (-9203) qaytadi.
• Agar yetkazib beruvchi hozir mavjud bo'lmasa (ishlaydigan akkaunt yo'q yoki barchasi limitga yetgan), javob 502 (-9006) bo'ladi: bir necha soniyadan keyin qayta urining.
• Xaridorga to'lovdan oldin ism va avatarni ko'rsating: bu "noto'g'ri username" xatolarining ko'pchiligining oldini oladi.

KeshCopy Anchor Link

Natijalar keshlanadi: topilganlari 15 daqiqaga, topilmaganlari 2 daqiqaga. Bir vaqtda kelgan bir xil so'rovlar yetkazib beruvchiga bitta so'rovga birlashtiriladi. Shuning uchun takroriy qidiruv arzon, qidiruvdan so'ng darhol yuborilgan POST /v1/orders esa yetkazib beruvchiga qayta murojaat qilmaydi.

Agar foydalanuvchi username'ni hozirgina yaratgan yoki o'zgartirgan bo'lsa, bir-ikki daqiqa kuting: salbiy natija hali keshda bo'lishi mumkin.

LimitCopy Anchor Link

Project uchun daqiqasiga 120 ta qidiruv (kalitning umumiy limiti o'rniga: qidiruvlar kalitning 600 so'roviga kirmaydi). Username'ni har bir tugma bosilganda tekshirmang, 300 dan 500 ms gacha debounce qiling.

curl -X GET "https://example.com/v1/recipients/lookup?username=string"

{  "success": true,  "data": {    "username": "durov",    "found": true,    "name": "Pavel Durov",    "photoUrl": "https://cdn4.telesco.pe/file/durov.jpg",    "eligible": true  },  "meta": {    "requestId": "9f1c2b7e-3a4d-4e5f-8a6b-7c8d9e0f1a2b",    "timestamp": "2026-10-06T09:15:22.481Z",    "processingTimeMs": 38  }}