API Telegram Premium và Stars
Gửi quà Telegram Premium và Telegram Stars từ ứng dụng, bot hoặc cửa hàng của bạn. API REST đơn giản với JSON, một khóa API, và đơn hàng trừ vào số dư với giá như trên web.
Bắt đầu
- Tạo tài khoản và nạp tiền tại trang Số dư.
- Vào Tài khoản của tôi > API để tạo khóa API. Khóa chỉ hiển thị một lần, hãy lưu lại trên máy chủ.
- Gửi khóa trong tiêu đề X-Api-Key với mọi yêu cầu.
URL cơ sở và định dạng
Mọi yêu cầu dùng HTTPS và JSON. Thành công trả về { "ok": true, "data": ... }. Lỗi trả về { "ok": false, "error": { "code", "message" } } với mã lỗi ổn định.
https://buytgpremium.com/api/v1
curl https://buytgpremium.com/api/v1/balance \
-H "X-Api-Key: btk_YOUR_KEY"
{ "ok": true, "data": { "credit": "120.00", "currency": "USD" } }Điểm cuối
| Phương thức | Đường dẫn | Chức năng |
|---|---|---|
| GET | /balance | Số dư của bạn (USD) |
| GET | /products | Các gói Premium và giá, phạm vi và gói Stars |
| GET | /recipient?username= | Kiểm tra username: cá nhân, kênh, nhóm, bot hoặc không tồn tại |
| POST | /quote | Tính giá đơn hàng và kiểm tra đủ số dư |
| POST | /orders | Đặt đơn hàng quà trừ vào số dư |
| GET | /orders?limit=&batch= | Đơn hàng gần đây (tối đa 100) |
| GET | /orders/{code} | Xem một đơn hàng theo mã |
Đặt đơn hàng
Premium: sản phẩm "premium", tháng 3, 6 hoặc 12, tối đa 10 username người nhận. Stars: sản phẩm "stars", stars từ 3,500 đến 550,000, và một username người nhận. Tổng số được trừ từ số dư của bạn ngay lập tức và một đơn hàng được tạo cho mỗi người nhận.
curl -X POST https://buytgpremium.com/api/v1/orders \
-H "X-Api-Key: btk_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"product":"premium","months":12,"recipients":["alice","bob"]}'
{ "ok": true, "data": { "batch": "B-7KQ2-...", "total": "34.00", "currency": "USD",
"orders": [ { "code": "G-4MZ8-...", "product": "premium", "recipient": "alice", "months": 12,
"price": "17.00", "status": "completed" }, ... ] } }curl -X POST https://buytgpremium.com/api/v1/orders \
-H "X-Api-Key: btk_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"product":"stars","stars":5000,"recipient":"alice"}'Mã lỗi
| Mã | Ý nghĩa |
|---|---|
| thiếu_api_key / api_key_không_hợp_lệ | Thiếu khóa hoặc khóa sai/đã bị thay thế (401) |
| đầu_vào_không_hợp_lệ / người_nhận_không_hợp_lệ | Kiểm tra sản phẩm, số tháng, Stars hoặc username (400) |
| recipient_not_user | Username này là kênh, nhóm hoặc bot, hoặc không tồn tại |
| insufficient_credit | Số dư thấp hơn tổng đơn hàng; vui lòng nạp thêm |
| network_error | Lỗi mạng tạm thời; số dư của bạn không thay đổi, vui lòng thử lại |
| rate_limited | Trên 120 yêu cầu mỗi phút mỗi khóa (429, xem Retry-After) |
Giới hạn và an toàn
- 120 yêu cầu mỗi phút trên mỗi khóa; 60 kiểm tra người nhận mỗi 10 phút.
- Một khóa cho mỗi tài khoản. Thay thế khóa sẽ ngừng khóa cũ ngay lập tức.
- Lưu trữ khóa trên máy chủ của bạn. Không bao giờ đặt khóa trên trang web hoặc ứng dụng di động.