Qo'llanma15-yanvar, 2025· 8 daqiqa

REST API orqali Telegram Stars yuborish: to'liq qo'llanma

Node.js, Python va cURL misollari bilan StarsPaymee API integratsiyasini bosqichma-bosqich o'rganing.

Boshlashdan oldin

StarsPaymee API bilan ishlash uchun sizga kerak:

API kalit (USDT balansingiz)

Qabul qiluvchi Telegram username'i

Yetkazmoqchi bo'lgan Stars miqdori (50–10,000)

Autentifikatsiya

Har bir so'rovda API kalitingizni header orqali yuboring:

bash

X-API-Key: sj_your_api_key_here
# yoki
Authorization: Bearer sj_your_api_key_here

1. Recipient'ni tekshirish

Stars yuborishdan oldin username'ni tekshiring:

bash

curl -X POST https://api.starstg.uz/api/purchase/v1/search \
  -H "X-API-Key: sj_your_key" \
  -H "Content-Type: application/json" \
  -d '{"product_type":"stars","query":"durov","quantity":"500"}'

Javob:

json

{
  "success": true,
  "found": {
    "name": "Pavel Durov",
    "photo": "https://...",
    "recipient": "durov",
    "myself": false
  }
}

2. Balansni tekshirish

bash

curl https://api.starstg.uz/api/purchase/v1/balance \
  -H "X-API-Key: sj_your_key"

3. Stars yuborish

javascript

const res = await fetch(
  "https://api.starstg.uz/api/purchase/v1/stars",
  {
    method: "POST",
    headers: {
      "X-API-Key": process.env.STARSPAYMEE_API_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      username: "durov",
      stars: 500,
      idempotency_key: crypto.randomUUID(),
    }),
  }
);

const data = await res.json();
console.log(data.transaction_id); // Fragment tx id

Xato holatlari

Status	Sabab	Yechim
402	Balans yetarli emas	USDT to'ldiring
400	Noto'g'ri username	/search bilan tekshiring
429	Ko'p so'rov	1 daqiqa kuting
502	Fragment xatosi	Balans qaytariladi

Python bilan to'liq misol

python

import httpx
import uuid

API_KEY = "sj_your_key"
BASE = "https://api.starstg.uz/api/purchase/v1"

def send_stars(username: str, amount: int) -> dict:
    with httpx.Client() as client:
        r = client.post(
            f"{BASE}/stars",
            headers={"X-API-Key": API_KEY},
            json={
                "username": username,
                "stars": amount,
                "idempotency_key": str(uuid.uuid4()),
            },
            timeout=180,
        )
        return r.json()

result = send_stars("durov", 500)
if result["success"]:
    print(f"Yetkazildi! tx={result['transaction_id']}")

Hammasi shu — 3 qadam va Stars yetkazildi!

← Barcha maqolalar Telegram'da ulashing