StardDevelopersداشبورد

شروع سریع: اولین درخواست به Stard API

در پنج قدم: ورود، ساخت کلید test، اولین درخواست، اولین سفارش آزمایشی و رفتن به live.

۱. ورود به داشبورد

به داشبورد توسعه‌دهندگان برو و با تلگرام (کد ربات @Stard_marketbot) یا گوگل وارد شو. یک پروژه‌ی پیش‌فرض و ۱۰۰ میلیون تومان موجودی آزمایشی برایت ساخته می‌شود.

۲. ساخت کلید test

در بخش «کلیدهای API» یک کلید با محیط test بساز. کلید فقط همان یک بار نمایش داده می‌شود؛ آن را در متغیر محیطی نگه دار، نه در کد:

ترمینال
export STARD_API_KEY=sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

۳. اولین درخواست

قیمت ۵۰۰ استارز را بگیر:

curl "https://stard-market.ir/api/v1/stars/price?quantity=500" \
  -H "Authorization: Bearer $STARD_API_KEY"
پاسخ — 200
{
  "object": "stars_price",
  "quantity": 500,
  "unit_price": 4382,
  "amount": 2191000,
  "currency": "IRT",
  "updated_at": "2026-10-01T10:31:49Z"
}

۴. اولین سفارش آزمایشی

با کلید test سفارش در sandbox ثبت می‌شود؛ همه‌ی اعتبارسنجی‌ها و قیمت‌ها واقعی‌اند ولی پولی جابه‌جا نمی‌شود:

curl -X POST "https://stard-market.ir/api/v1/orders" \
  -H "Authorization: Bearer $STARD_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: first-order-1" \
  -d '{"type": "stars", "quantity": 500, "recipient": "@durov"}'
پاسخ — 201
{
  "object": "order",
  "id": "ord_test_TyrINakBwx0N66kV",
  "order_id": null,
  "environment": "test",
  "status": "pending",
  "raw_status": "pending",
  "title": "⭐ 500 استارز برای @durov (test)",
  "product_id": null,
  "product_tag": null,
  "type": "stars",
  "quantity": 500,
  "recipient": "@durov",
  "amount": {
    "amount": 2191000,
    "currency": "IRT"
  },
  "paid": {
    "amount": 2191000,
    "currency": "IRT"
  },
  "failure_reason": null,
  "metadata": {},
  "created_at": "2026-10-01T10:31:49Z",
  "updated_at": "2026-10-01T10:31:49Z"
}

۵. رفتن به live

وقتی یکپارچه‌سازی کامل شد، حساب تلگرام Stard را در داشبورد وصل کن (اگر با گوگل وارد شده‌ای)، از بخش «کیف پول API» داشبورد با یک کلیک از ولت TON خودت (Tonkeeper یا هر ولت) شارژ کن و یک کلید live بساز. کد تو تغییری نمی‌کند؛ فقط کلید عوض می‌شود. تفاوت test و live