StardDevelopersداشبورد

بوست کانال: مدت‌ها و قیمت

GET/api/v1/boosts
scope: prices:readاحراز هویت: Bearerlive و test

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

درخواست

ناممحلنوعتوضیح
AuthorizationheaderstringالزامیBearer sk_live_… یا Bearer sk_test_…

نمونه

curl "https://stard-market.ir/api/v1/boosts" \
  -H "Authorization: Bearer $STARD_API_KEY"
پاسخ — 200
{
  "object": "boost_catalog",
  "enabled": true,
  "currency": "IRT",
  "max_quantity": 1000,
  "durations": [
    {
      "duration": 7,
      "label": "۷ روزه",
      "price_per_boost": 13200,
      "available": true
    },
    {
      "duration": 14,
      "label": "۱۴ روزه",
      "price_per_boost": null,
      "available": false
    },
    {
      "duration": 30,
      "label": "۱ ماهه",
      "price_per_boost": 32100,
      "available": true
    },
    {
      "duration": 60,
      "label": "۲ ماهه",
      "price_per_boost": 79500,
      "available": true
    }
  ],
  "raw": null
}
هدرهای پاسخ
content-type: application/json
x-request-id: req_0gcZ6fXsruRRhsu6DSbU
x-ratelimit-limit: 1000
x-ratelimit-remaining: 994

خطاها

HTTPcodeکی
403insufficient_scopeکلید scope prices:read را ندارد
401invalid_api_key / missing_api_key / api_key_revoked / api_key_expiredکلید نیامده، نامعتبر، باطل یا منقضی است
429rate_limit_exceededسقف درخواست در دقیقه پر شده؛ بعد از Retry-After ثانیه دوباره بفرست

محدودیت نرخ

پیش‌فرض ۶۰ درخواست در دقیقه برای هر کلید (قابل تنظیم در داشبورد). وضعیت در هدرهای X-RateLimit-* برمی‌گردد — جزئیات.