API สำหรับ Telegram Premium และ Stars

ส่งของขวัญ Telegram Premium และ Telegram Stars จากแอป บอต หรือร้านค้าของคุณเอง REST API ขนาดเล็กที่มี JSON คีย์ API หนึ่งเดียว และคำสั่งซื้อที่ชำระจากเครดิตของคุณในราคาเดียวกับเว็บไซต์

เริ่มต้นใช้งาน

สร้างบัญชีและเติมเครดิตในหน้าเครดิต
เปิดเมนูบัญชีของฉัน จากนั้นเลือก API และสร้างคีย์ API ของคุณ คีย์จะแสดงเพียงครั้งเดียว ดังนั้นให้เก็บไว้บนเซิร์ฟเวอร์ของคุณ
ส่งคีย์ในส่วนหัว X-Api-Key ทุกครั้งที่ร้องขอ

สร้างคีย์ API ของคุณ

URL พื้นฐานและรูปแบบ

คำขอทั้งหมดใช้ HTTPS และ JSON การตอบสนองที่สำเร็จจะเป็น { "ok": true, "data": ... } การตอบสนองที่ผิดพลาดจะเป็น { "ok": false, "error": { "code", "message" } } พร้อมรหัสที่คงที่

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" } }

จุดปลายทาง

วิธีการ	เส้นทาง	หน้าที่
GET	/balance	เครดิตของคุณใน USD
GET	/products	ระยะเวลาและราคาของ Premium ช่วงและแพ็กเกจของ Stars
GET	/recipient?username=	ตรวจสอบชื่อผู้ใช้: บุคคล, ช่องทาง, กลุ่ม, บอต หรือไม่พบ
POST	/quote	ราคาของคำสั่งซื้อและว่าเครดิตของคุณครอบคลุมหรือไม่
POST	/orders	ทำคำสั่งซื้อของขวัญที่ชำระจากเครดิต
GET	/orders?limit=&batch=	คำสั่งซื้อล่าสุดของคุณ (สูงสุด 100)
GET	/orders/{code}	หนึ่งคำสั่งซื้อตามรหัส

การทำคำสั่งซื้อ

Premium: ผลิตภัณฑ์ "premium" ระยะเวลา 3, 6 หรือ 12 เดือน และส่งให้ได้สูงสุด 10 username ใน recipients Stars: ผลิตภัณฑ์ "stars" จำนวน Stars ตั้งแต่ 3,500 ถึง 550,000 และหนึ่ง username ใน recipient ระบบจะหักเครดิตของคุณทันทีและสร้างหนึ่งคำสั่งซื้อต่อ recipient

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"}'

รหัสข้อผิดพลาด

รหัส	ความหมาย
ไม่มี API Key / API Key ไม่ถูกต้อง	ไม่มีคีย์ หรือคีย์ผิดหรือถูกแทนที่ (401)
ข้อมูลไม่ถูกต้อง / ผู้รับไม่ถูกต้อง	ตรวจสอบสินค้า, จำนวนเดือน, Stars หรือชื่อผู้ใช้ (400)
recipient_not_user	ชื่อผู้ใช้เป็นช่อง, กลุ่ม หรือบอท หรือไม่มีอยู่จริง
insufficient_credit	เครดิตไม่เพียงพอสำหรับคำสั่งซื้อ; โปรดเติมเครดิต
network_error	เกิดข้อผิดพลาดชั่วคราวของเครือข่าย; เครดิตของคุณไม่เปลี่ยนแปลง โปรดลองอีกครั้ง
rate_limited	มากกว่า 120 คำขอต่อนาทีต่อคีย์ (429 ดู Retry-After)

ขีดจำกัดและความปลอดภัย

120 คำขอต่อนาทีต่อคีย์; 60 การตรวจสอบผู้รับต่อทุก 10 นาที
หนึ่งคีย์ต่อบัญชี การเปลี่ยนคีย์จะหยุดการทำงานของคีย์เก่าทันที
เก็บคีย์ไว้บนเซิร์ฟเวอร์ของคุณ อย่าใส่ในหน้าเว็บหรือแอปมือถือ