StardDevelopersداشبورد

کلیدهای API: ساخت، چرخش و ابطال

کلیدها برای هر پروژه و محیط جدا ساخته می‌شوند، scope و سقف نرخ و تاریخ انقضا دارند و فقط هش آن‌ها ذخیره می‌شود.

قالب کلید

sk_live_ یا sk_test_ و ۴۰ کاراکتر تصادفی (حدود ۲۳۸ بیت). Stard فقط HMAC کلید را نگه می‌دارد؛ حتی پشتیبانی Stard هم نمی‌تواند کلید تو را ببیند. اگر گمش کردی، کلید تازه بساز.

Scopeها

scopeاجازه
products:readمحصولات، دسته‌ها، مزایده‌ها، آمار بازار
prices:readقیمت استارز، TON، دلار، پریمیوم و محصولات
orders:readخواندن سفارش‌های همین پروژه
orders:writeثبت و لغو سفارش (در live با پول واقعی)
wallet:readموجودی و تراکنش‌ها
wallet:writeتبدیل تومان↔TON و برداشت TON به کیف پول وصل‌شده (پیش‌فرض نیست؛ صریحاً انتخاب کن)
webhooks:readخواندن رویدادها

اصل کمترین دسترسی: کلیدی که فقط قیمت نشان می‌دهد نباید orders:write داشته باشد.

چرخش (rotate)

چرخش یک کلید تازه با همان تنظیمات می‌سازد. کلید قبلی یا فوراً باطل می‌شود یا تا مهلتی که تعیین می‌کنی (حداکثر ۷۲ ساعت) کار می‌کند تا بتوانی بدون قطعی سرویس، کلید را در سرورهایت عوض کنی.

ابطال

ابطال فوری است؛ درخواست بعدی با آن کلید 401 api_key_revoked می‌گیرد. اگر کلید لو رفت، اول ابطال، بعد بررسی لاگ‌ها.