StardDevelopersداشبورد

اطلاعات و ری‌اکشن‌های پست

POST/api/v1/services/post-info
scope: prices:readاحراز هویت: Bearerlive و test

عنوان کانال، متن، بازدید و ری‌اکشن‌های فعلی پست (ایموجی، استارزی و سفارشی) به‌همراه ری‌اکشن‌های مجاز کانال (allowed؛ null یعنی محدودیتی نیست). اگر status=pending بود، ۱ تا ۳ ثانیه بعد همان درخواست را تکرار کن. نتیجه ۱۰ دقیقه کش می‌شود؛ fresh=true کش را دور می‌زند.

درخواست

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

بدنه (JSON)

فیلدنوعتوضیح
linkstringالزامیلینک پست: https://t.me/channel/123
freshbooleanاختیارینادیده گرفتن کش

نمونه

curl -X POST "https://stard-market.ir/api/v1/services/post-info" \
  -H "Authorization: Bearer $STARD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"link": "https://t.me/your_channel/42"}'
پاسخ — 200
{
  "object": "post_info",
  "link": "https://t.me/your_channel/42",
  "allowed": [
    "❤",
    "👍",
    "🔥",
    "🎉",
    "custom"
  ],
  "status": "done",
  "title": "Your Channel",
  "text": "متن پست…",
  "views": 12840,
  "reactions": [
    {
      "emoji": "👍",
      "count": 412
    },
    {
      "emoji": "❤",
      "count": 190
    },
    {
      "paid": true,
      "count": 25
    },
    {
      "custom_id": "5413794461152978282",
      "count": 12
    }
  ],
  "paid_enabled": true
}

خطاها

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

محدودیت نرخ

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