StardDevelopersداشبورد

آمار بازار

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

تعداد آیتم‌های موجود، کف قیمت، تعداد مزایده‌ها و آگهی‌های کاربران به تفکیک دسته.

درخواست

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

نمونه

curl "https://stard-market.ir/api/v1/marketplace" \
  -H "Authorization: Bearer $STARD_API_KEY"
پاسخ — 200
{
  "object": "marketplace",
  "currency": "IRT",
  "categories": [
    {
      "category": "gift",
      "available": 4555,
      "floor_price": 1726086,
      "auctions": 0,
      "p2p_listings": 0
    },
    {
      "category": "number",
      "available": 175,
      "floor_price": 121058966,
      "auctions": 0,
      "p2p_listings": 0
    }
  ],
  "updated_at": "2026-10-01T10:31:49Z"
}
هدرهای پاسخ
x-request-id: req_1AH8666Ot6nNS3FYGEZJ
x-ratelimit-limit: 60
x-ratelimit-remaining: 49
x-ratelimit-reset: 1790850720

خطاها

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

محدودیت نرخ

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