Umumiy ma'lumot

PayStars.uz API orqali tashqi dasturlar va xizmatlardan Telegram Stars va Premium sotib olish mumkin. API RESTful arxitekturada qurilgan va JSON formatida javob qaytaradi.

Base URL: https://paystars.uz/api/v1

Content-Type: application/json

Autentifikatsiya

Barcha API so'rovlari X-API-Key header orqali autentifikatsiya qilinadi. API key ni Dashboard orqali yaratishingiz mumkin.

Header: X-API-Key: ps_your_api_key_here

API key yaratish uchun: Dashboard → API Keys → Yangi key tugmasini bosing.

Xatoliklar

API xatolik yuz berganda quyidagi formatda javob qaytaradi:

{ "detail": "Xatolik haqida xabar" }
Status Code Tavsif
200 Muvaffaqiyat
400 Noto'g'ri so'rov (parametrlar xato)
401 Autentifikatsiya xatosi (API key noto'g'ri)
404 Resurs topilmadi
500 Ichki server xatosi

Stars sotib olish

POST /api/v1/stars/buy
Belgilangan foydalanuvchiga Telegram Stars yuborish

PARAMETRLAR

Nomi Turi Tavsif
username * string Telegram username (@ belgi shart emas)
quantity * integer Stars miqdori (50 — 5000)
bot_id integer Agar bir nechta bot bo'lsa, aniq bot ID

JAVOB

{ "success": true, "status": "confirmed", "username": "durov", "amount": 100, "message": "Stars yuborildi", "order_id": 42 }

Premium sotib olish

POST /api/v1/premium/buy
Belgilangan foydalanuvchiga Telegram Premium berish
Nomi Turi Tavsif
username * string Telegram username
months * integer Premium muddati: 3, 6 yoki 12 oy
bot_id integer Bot ID (ixtiyoriy)
{ "success": true, "status": "confirmed", "username": "durov", "amount": 3, "message": "Premium 3 oyga berildi" }

Balans tekshirish

GET /api/v1/balance
Hisobingizdagi balansni tekshirish
{ "balance": 1250000.0, "bot_username": "myshopbot" }

Narxlar

GET /api/v1/prices
Joriy narxlarni ko'rish
{ "star_price": 215.0, "premium_3_price": 160000.0, "premium_6_price": 220000.0, "premium_12_price": 400000.0, "min_stars": 50, "max_stars": 5000 }

API holati

GET /api/v1/status
API ishlash holatini tekshirish (autentifikatsiya shart emas)
{ "status": "online", "service": "PayStars.uz API", "version": "2.0.0" }

Python namunasi

Python (requests) 
import requests

# API key
API_KEY = "ps_your_api_key_here"
BASE_URL = "https://paystars.uz/api/v1"
headers = {"X-API-Key": API_KEY}

# ⭐ Stars sotib olish
resp = requests.post(
    f"{BASE_URL}/stars/buy",
    headers=headers,
    json={
        "username": "durov",
        "quantity": 100
    }
)
data = resp.json()
print(data["status"])  # "confirmed"

# Premium sotib olish
resp = requests.post(
    f"{BASE_URL}/premium/buy",
    headers=headers,
    json={
        "username": "durov",
        "months": 3
    }
)
print(resp.json())

# Balans tekshirish
balance = requests.get(
    f"{BASE_URL}/balance",
    headers=headers
).json()
print(f"Balans: {balance['balance']} so'm")

Node.js namunasi

Node.js (axios) 
const axios = require('axios');

const client = axios.create({
    baseURL: 'https://paystars.uz/api/v1',
    headers: {
        'X-API-Key': 'ps_your_api_key_here'
    }
});

# Stars sotib olish
async function buyStars(username, quantity) {
    const { data } = await client.post('/stars/buy', {
        username,
        quantity
    });
    return data;
}

// Premium sotib olish
async function buyPremium(username, months) {
    const { data } = await client.post('/premium/buy', {
        username,
        months
    });
    return data;
}

// Ishlatish
buyStars('durov', 100).then(console.log);

cURL namunasi

cURL 
# Stars sotib olish
curl -X POST https://paystars.uz/api/v1/stars/buy \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ps_your_api_key_here" \
  -d '{"username": "durov", "quantity": 100}'

# Premium sotib olish
curl -X POST https://paystars.uz/api/v1/premium/buy \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ps_your_api_key_here" \
  -d '{"username": "durov", "months": 3}'

# Balans tekshirish
curl https://paystars.uz/api/v1/balance \
  -H "X-API-Key: ps_your_api_key_here"

# Narxlar
curl https://paystars.uz/api/v1/prices \
  -H "X-API-Key: ps_your_api_key_here"

# Holat tekshirish (auth shart emas)
curl https://paystars.uz/api/v1/status

Rate Limits

Default holatda har bir API key uchun soatiga 100 ta so'rov mumkin. Limit o'zgartirish uchun admin bilan bog'laning.

Yordam kerakmi?

Telegram orqali yozing — tez javob beramiz

Telegram Support