★ برای توسعه‌دهندگان

Telegram Stars API

Telegram Stars و Premium را داخل ربات، فروشگاه یا اپ خودتان بفروشید. یک API با HTTPS، یک موجودی مشترک با ربات StarKerak و وب‌سایت.

تحویل خودکاربیشتر سفارش‌ها در چند دقیقه
بررسی نام کاربریپیش از پرداخت
قیمت‌های عمومییکسان در سایت و API
دفترکل عمومیهر سفارش یک TxId می‌گیرد

API چه می‌کند

  • POST /api/v1/check-username — گیرنده را بررسی کنید و یک توکن تأیید کوتاه‌عمر بگیرید
  • POST /api/v1/stars/buy و /api/v1/premium/buy — ساخت سفارش (Idempotency-Key الزامی است)
  • GET /api/v1/order/{id} و /api/v1/orders — وضعیت‌ها و تاریخچه
  • GET /api/v1/prices، /api/v1/account، کیف پول USD و فاکتورهای USDT

احراز هویت با هدر X-API-Key انجام می‌شود. کلیدها در داشبورد ساخته می‌شوند و تا وقتی خودتان لغوشان نکنید منقضی نمی‌شوند.

ساخته‌شده برای محیط عملیاتی

هر سفارش Idempotency-Key شما را دارد، پس تلاش دوباره هرگز دوبار کسر نمی‌کند. بررسی گیرنده از پرداخت به نام‌های کاربری ناموجود جلوگیری می‌کند. محدودیت نرخ 10 درخواست در ثانیه برای هر کلید است.

همه سفارش‌ها از موجودی USD پرداخت می‌شوند (currency=USD؛ UZS به‌عنوان USD در نظر گرفته می‌شود). max_usd را بفرستید تا سقف قیمت پذیرفته‌شده را تعیین کنید.

شفافیت

هر سفارش تکمیل‌شده یک TxId می‌گیرد که در دفتر عمومی PayStars ثبت می‌شود، تا شما و مشتریانتان تحویل را مستقل بررسی کنید.

قیمت Fragment، ۰٪ (وب‌سایت: ۵٪) بها

سفارش‌های کلید API از موجودی USD با قیمت لحظه‌ای Fragment و ۰٪ (وب‌سایت: ۵٪) بها قیمت‌گذاری می‌شوند؛ سفارش‌های سایت و مینی‌اپ مبلغ دقیق پیش از پرداخت نشان داده می‌شود. قیمت را با POST /usd/quote بگیرید و با max_usd سقف بگذارید. جزئیات در صفحه Fragment API است.

پرسش‌های متداول

آیا محیط آزمایشی وجود دارد؟

هنگام یکپارچه‌سازی از سفارش‌های واقعی کوچک (50 Stars) استفاده کنید؛ کلید تکرارپذیری تلاش‌های دوباره را امن می‌کند.

کدام زبان‌ها پشتیبانی می‌شوند؟

هر زبانی با HTTPS. راهنمای سریع Python، Node.js و PHP را ببینید.

آیا کلیدهای API منقضی می‌شوند؟

نه. کلیدها تا وقتی در داشبورد لغوشان نکنید معتبر می‌مانند.

آیا می‌توانم با USD پرداخت کنم؟

بله — موجودی USD را با USDT (TON، BEP20 یا TRC20) شارژ کنید و currency=USD بفرستید.

آماده سفارش هستید؟

ورود با Telegram — موجودی StarKerak شما در سایت، در WebApp و از طریق API کار می‌کند.