StardDevelopersداشبورد

قیمت دقیق خدمت

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

همان مبلغی که POST /services/orders با همین پارامترها کسر می‌کند. با drip_runs قیمت ارسال تدریجی را می‌گیری (سرویس باید هر مرحله را بپذیرد).

درخواست

ناممحلنوعتوضیح
AuthorizationheaderstringالزامیBearer sk_live_… یا Bearer sk_test_…
servicepathstringالزامیشناسه‌ی خدمت از GET /services (مثل reactions، members، views)
quantityqueryintegerالزامیتعداد کل
reactionquerystringاختیاریفقط reactions: از GET /services/reactions/options
optionquerystringاختیاریسطح ضمانت یا تعداد پست از /options
drip_runsqueryintegerاختیاریارسال تدریجی: تعداد مرحله (۲ تا ۲۰)

نمونه

curl "https://stard-market.ir/api/v1/services/reactions/price?quantity=500&reaction=e%3A%F0%9F%91%8D" \
  -H "Authorization: Bearer $STARD_API_KEY"
پاسخ — 200
{
  "object": "service_price",
  "service": "reactions",
  "quantity": 500,
  "amount": 16000,
  "unit_price": 32,
  "currency": "IRT",
  "reaction": "e:👍",
  "option": null,
  "drip_runs": null,
  "guarantee_days": null
}
هدرهای پاسخ
content-type: application/json
x-request-id: req_3zcsZkV0XzcX9jDEw4bV
x-ratelimit-limit: 1000
x-ratelimit-remaining: 994

خطاها

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

محدودیت نرخ

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