StardDevelopersداشبورد

گزینه‌های خدمت

GET/api/v1/services/{service}/options
scope: prices:readاحراز هویت: Bearerlive و test

برای ممبر و ممبر پریمیوم سطح ضمانت (kind=guarantee: ۷، ۳۰، ۹۰ روزه یا مادام‌العمر) و برای خدمات چندپستی تعداد پست (kind=post_count: مثلاً ۱۰ پست آخر یا ۵۰ پست بعدی) با مبلغ همان تعداد. id را به‌صورت option بفرست. در خدمات چندپستی تعداد سفارش «به ازای هر پست» است.

درخواست

ناممحلنوعتوضیح
AuthorizationheaderstringالزامیBearer sk_live_… یا Bearer sk_test_…
servicepathstringالزامیشناسه‌ی خدمت از GET /services (مثل reactions، members، views)
quantityqueryintegerالزامیتعداد

نمونه

curl "https://stard-market.ir/api/v1/services/members/options?quantity=1000" \
  -H "Authorization: Bearer $STARD_API_KEY"
پاسخ — 200
{
  "object": "list",
  "service": "members",
  "quantity": 1000,
  "kind": "guarantee",
  "currency": "IRT",
  "data": [
    {
      "id": "g30",
      "label": "ضمانت ۳۰ روزه+",
      "amount": 69000,
      "guarantee_days": 30
    },
    {
      "id": "g90",
      "label": "ضمانت ۹۰ روزه+",
      "amount": 133000,
      "guarantee_days": 90
    }
  ]
}
هدرهای پاسخ
content-type: application/json
x-request-id: req_yduU4E0N6ZEh1glzgD8l
x-ratelimit-limit: 1000
x-ratelimit-remaining: 996

خطاها

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

محدودیت نرخ

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