Tezkor boshlash

iFragment: Telegram Stars va Premium yetkazib berish platformasi. Siz REST API orqali buyurtma yaratasiz, platforma uni izolyatsiya qilingan Supplier Accounts orqali bajaradi va natijani vebxuk orqali yuboradi.

1. Kalit olingCopy Anchor Link

Kalit Project uchun beriladi. Project bu akkauntingiz ichidagi integratsiya (masalan, "bot" va "sayt" uchun alohida). Kalit dasturchi portalida chiqariladi: Google yoki Telegram orqali kiring, ulanish anketasini to'ldiring (loyiha, qayerda ishlaydi, hudud, pochta) - kompaniya va birinchi Project darhol yaratiladi - va unda kalit chiqaring. Kalit faqat bir marta ko'rsatiladi:

ifk_48aa52d67c0fef6d_lVlZSWKN43sgb2vfEpFbqtzQ0ePNZya6yZr

Batafsil: Autentifikatsiya.

2. Qabul qiluvchini tekshiringCopy Anchor Link

curl "https://api.ifragment.com/v1/recipients/lookup?username=durov&product=STARS" \
  -H "X-API-Key: $IFRAGMENT_KEY"

{
  "success": true,
  "data": { "username": "durov", "found": true, "name": "Pavel Durov", "photoUrl": "https://…", "eligible": true },
  "meta": { "requestId": "…", "timestamp": "…", "processingTimeMs": 12 }
}

3. Buyurtma yaratingCopy Anchor Link

curl -X POST https://api.ifragment.com/v1/orders \
  -H "X-API-Key: $IFRAGMENT_KEY" \
  -H "Idempotency-Key: order-1042" \
  -H "Content-Type: application/json" \
  -d '{ "product": "STARS", "quantity": 500, "username": "durov", "externalId": "1042" }'

{
  "success": true,
  "data": {
    "id": "0199a1b2-6f00-7abc-9def-112233445566",
    "externalId": "1042",
    "product": "STARS",
    "quantity": 500,
    "months": null,
    "username": "durov",
    "recipientName": "Pavel Durov",
    "status": "QUEUED",
    "price": "8.25",
    "currency": "USD",
    "failure": null,
    "createdAt": "2026-09-26T10:15:30.000Z",
    "sentAt": null,
    "completedAt": null
  },
  "meta": { "requestId": "…", "timestamp": "…", "processingTimeMs": 48 }
}

201 javobi buyurtma QUEUED holatida ekanini va uning narxi balansda allaqachon bloklanganini bildiradi. externalId bu sizning tizimingizdagi buyurtma id'si: buyurtmani u orqali topish mumkin, bir xil externalId bilan ikkinchi buyurtma esa yaratilmaydi.

4. Natijani kutingCopy Anchor Link

Eng yaxshi usul: order.succeeded / order.failed vebxuki. Oddiy integratsiyalar uchun GET /v1/orders/{id} ni yakuniy holatgacha (SUCCEEDED yoki FAILED) har necha soniyada so'rab turish ham yetarli.

Asosiy qoidalarCopy Anchor Link

• Asosiy manzil: https://api.ifragment.com, yo'ldagi versiya: /v1.
• Barcha javoblar { success, data, meta } ko'rinishidagi JSON; xatolar { success: false, error, meta } ko'rinishida keladi, qarang: Xatolar.
• Xato xabarlari tili Accept-Language: uz | ru | en sarlavhasi bilan tanlanadi.
• Summalar aniqlik yo'qolmasligi uchun AQSh dollaridagi satrlar ("1.65", "0.0165") sifatida keladi; hisob-kitob uchun ularni float'ga o'tkazmang.
• Vaqt ISO 8601 formatida, UTC bo'yicha.