BuyTgPremium

텔레그램 프리미엄·스타 API

내 앱, 봇, 쇼핑몰에서 텔레그램 프리미엄과 텔레그램 스타 선물을 보낼 수 있어요. JSON으로 주고받는 작은 REST API이고, API 키 하나로 쓰며, 주문은 사이트와 같은 가격으로 크레딧에서 결제돼요.

시작하기

  • 계정을 만들고 크레딧 페이지에서 크레딧을 충전해요.
  • 내 계정의 API 메뉴에서 API 키를 만들어요. 키는 한 번만 보여 드리니 내 서버에 저장해 두세요.
  • 요청마다 X-Api-Key 헤더에 키를 넣어요.
API 키 만들기

기본 주소와 형식

모든 요청은 HTTPS와 JSON을 써요. 성공하면 { "ok": true, "data": ... }, 실패하면 { "ok": false, "error": { "code", "message" } }로 답하고, code 값은 바뀌지 않아요.

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프리미엄 기간과 가격, 스타 범위와 묶음
GET/recipient?username=아이디 확인: 개인, 채널, 그룹, 봇, 없음
POST/quote주문 금액과 크레딧이 충분한지
POST/orders크레딧으로 선물 주문
GET/orders?limit=&batch=최근 주문(최대 100개)
GET/orders/{code}주문 코드로 한 건 보기

주문 넣기

프리미엄: product "premium", months 3·6·12 중 하나, recipients에 아이디 최대 10개. 스타: product "stars", stars 3,500~550,000, 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"}'

오류 코드

코드뜻
missing_api_key / invalid_api_key키가 없거나 틀렸거나 바뀐 키예요(401)
invalid_input / invalid_recipient상품, 기간, 스타 개수, 아이디를 확인해 주세요(400)
recipient_not_user채널, 그룹, 봇이거나 없는 아이디예요
insufficient_credit크레딧이 주문 금액보다 적어요. 크레딧을 충전해 주세요
network_error잠깐의 네트워크 오류예요. 크레딧은 그대로이고, 다시 시도해 주세요
rate_limited키 하나에 1분 120번을 넘었어요(429, Retry-After 참고)

한도와 안전

  • 키 하나에 1분 120번, 아이디 확인은 10분에 60번까지예요.
  • 계정마다 키는 하나예요. 키를 바꾸면 예전 키는 바로 멈춰요.
  • 키는 내 서버에만 두세요. 웹 페이지나 휴대폰 앱 안에 넣지 마세요.
텔레그램 프리미엄·스타 API, 리셀러와 봇용 | BuyTgPremium