StardDevelopersداشبورد

ثبت سفارش ری‌اکشن استارزی

POST/api/v1/star-reactions/orders
scope: orders:writeاحراز هویت: Bearerlive و test

ری‌اکشن استارزی روی یک یا چند پست متوالی، با امکان ناشناس و زمان‌بندی. از Idempotency-Key پشتیبانی می‌کند و تغییر وضعیت با وب‌هوک order.* خبر داده می‌شود.

درخواست

ناممحلنوعتوضیح
AuthorizationheaderstringالزامیBearer sk_live_… یا Bearer sk_test_…
Idempotency-Keyheaderstringاختیاریکلید یکتا برای جلوگیری از سفارش تکراری

بدنه (JSON)

فیلدنوعتوضیح
post_urlstringالزامیلینک پست
starsintegerالزامیاستارز برای هر پست
postsintegerاختیاریتعداد پست (۱ تا ۵۰)
anonymousbooleanاختیاریناشناس
scheduled_atstringاختیاریزمان ارسال (ISO 8601)
max_priceintegerاختیاریسقف مبلغ؛ بیشتر شد → 409 price_changed
pay_currencystringاختیاریTON یا IRT
metadataobjectاختیاریداده‌ی دلخواه

نمونه

curl -X POST "https://stard-market.ir/api/v1/star-reactions/orders" \
  -H "Authorization: Bearer $STARD_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: rx-1001" \
  -d '{"post_url": "https://t.me/your_channel/42", "stars": 50, "posts": 3, "anonymous": true}'

خطاها

HTTPcodeکی
400post_url_invalidلینک پست نامعتبر است
400quantity_out_of_rangeتعداد استارز خارج از بازه
403service_disabledری‌اکشن استارزی موقتاً غیرفعال است
409price_changedمبلغ از max_price بیشتر شد؛ پولی کسر نشده
402insufficient_fundsموجودی کیف پول API (یا موجودی آزمایشی) کافی نیست
403insufficient_scopeکلید scope orders:write را ندارد
401invalid_api_key / missing_api_key / api_key_revoked / api_key_expiredکلید نیامده، نامعتبر، باطل یا منقضی است
429rate_limit_exceededسقف درخواست در دقیقه پر شده؛ بعد از Retry-After ثانیه دوباره بفرست

محدودیت نرخ

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