StardDevelopersداشبورد

پرسش‌های رایج درباره‌ی Stard API

پاسخ کوتاه و دقیق به پرسش‌های رایج درباره‌ی API، هزینه، احراز هویت و خرید استارز.

پاسخ‌ها

اگر پاسخ پرسشت اینجا نیست، در کانال Stard بپرس.

پرسش‌های رایج

Stard API چیست؟

API رسمی Stard Market که با آن برنامه‌ها می‌توانند قیمت استارز و محصولات تلگرام را بخوانند و سفارش واقعی ثبت کنند.

آیا Stard API برای خرید استارز تلگرام دارد؟

بله. POST /api/v1/orders با type=stars؛ راهنما.

چطور کلید API بسازم؟

در داشبورد وارد شو و از بخش کلیدها یک کلید test یا live بساز.

احراز هویت چطور است؟

هدر Authorization: Bearer sk_live_…؛ کلید هرگز در URL نیاید.

استفاده از API چقدر هزینه دارد؟

خود API رایگان است؛ فقط مبلغ سفارش‌ها با همان قیمت فروشگاه از کیف پول کسر می‌شود.

محیط تست دارد؟

بله؛ کلیدهای sk_test_ با ۱۰۰ میلیون تومان موجودی آزمایشی و بدون پول واقعی کار می‌کنند.

وب‌هوک دارد؟

بله. از داشبورد توسعه‌دهنده یک آدرس https ثبت کن و رویدادهای order.created، order.processing، order.completed، order.cancelled، order.refunded و order.failed را با امضای HMAC-SHA256 دریافت کن؛ تحویل ناموفق تا ۸ بار با فاصله‌ی افزایشی دوباره فرستاده می‌شود. جزئیات و نمونه‌ی بررسی امضا در /docs/webhooks.

چه چیزهایی را می‌شود با API خرید؟

همه‌ی چیزهایی که ربات و مینی‌اپ می‌فروشند: استارز، پریمیوم، گیفت استارزی (با فرستنده‌ی مخفی، پیام با ایموجی پریمیوم و زمان‌بندی)، محصولات فروشگاه، بوست، همه‌ی خدمات کانال (ممبر — حتی با ادمین کردن ربات و آمار ورود/خروج — بازدید، ری‌اکشن، کامنت، ارسال تدریجی…) و ری‌اکشن استارزی؛ همه در live و test.

پیام خطا انگلیسی هم دارد؟

بله؛ هر خطا code ماشینی، message فارسی و message_en انگلیسی دارد.

سقف درخواست چقدر است؟

پیش‌فرض ۶۰ درخواست در دقیقه برای هر کلید؛ هدرهای X-RateLimit وضعیت را می‌گویند.