StardDevelopersداشبورد

مستندات API استارد (Stard API)

API رسمی Stard Market برای خرید خودکار استارز تلگرام، پریمیوم، گیفت، یوزرنیم و شماره و دریافت قیمت‌های لحظه‌ای.

پاسخ کوتاه: Stard API یک REST API رسمی است که با یک کلید sk_live_ یا sk_test_ در هدر Authorization کار می‌کند و به برنامه‌ی تو اجازه می‌دهد قیمت استارز و محصولات تلگرام را بخواند و سفارش واقعی ثبت کند.

Stard API چیست؟

Stard API یک REST API با پاسخ JSON است که همان امکانات فروشگاه و ربات Stard را در اختیار برنامه‌ی تو می‌گذارد: دیدن محصولات و قیمت‌ها، ثبت سفارش واقعی با پرداخت خودکار از کیف پول API (TON یا تومان) و پیگیری وضعیت سفارش. هیچ سیستم جداگانه‌ای پشتش نیست؛ سفارش‌های API دقیقاً با همان موتورهای خودکاری انجام می‌شوند که سفارش‌های مینی‌اپ را انجام می‌دهند.

آدرس پایه و قالب

همه‌ی درخواست‌ها به https://stard-market.ir/api/v1 فرستاده می‌شوند، با HTTPS و JSON (UTF-8). مبلغ‌ها عدد صحیح تومان‌اند (currency: "IRT") و مقدار TON رشته‌ی دقیق با ۹ رقم اعشار، تا هیچ خطای گرد کردن پیش نیاید. زمان‌ها ISO 8601 به وقت UTC هستند.

curl "https://stard-market.ir/api/v1/ping" \
  -H "Authorization: Bearer $STARD_API_KEY"

چه کارهایی می‌شود کرد؟