StardDevelopersداشبورد

مزایده‌های فعال

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

مزایده‌هایی که هنوز تمام نشده‌اند، به ترتیب نزدیک‌ترین زمان پایان، همراه تعداد پیشنهادها و بالاترین پیشنهاد.

درخواست

ناممحلنوعتوضیح
AuthorizationheaderstringالزامیBearer sk_live_… یا Bearer sk_test_…
limitqueryintegerاختیاریتعداد نتیجه در هر صفحه، ۱ تا ۱۰۰ (پیش‌فرض ۲۰)
offsetqueryintegerاختیاریچند ردیف رد شود (پیش‌فرض ۰)؛ برای صفحه‌ی بعد از next_offset استفاده کن

نمونه

curl "https://stard-market.ir/api/v1/auctions?limit=1" \
  -H "Authorization: Bearer $STARD_API_KEY"
پاسخ — 200
{
  "object": "list",
  "data": [
    {
      "object": "auction",
      "id": 23115,
      "tag": "5NJIL7",
      "name": "@stard_sample",
      "description": "یوزرنیم نمونه",
      "category": "username",
      "pricing_type": "auction",
      "price": {
        "amount": 8500000,
        "currency": "IRT"
      },
      "starting_price": {
        "amount": 8500000,
        "currency": "IRT"
      },
      "auction_end_at": "2026-09-09T03:34:21Z",
      "stars_price": null,
      "available": true,
      "purchasable_via_api": false,
      "not_purchasable_reason": "p2p_not_supported",
      "marketplace": "p2p",
      "image_url": null,
      "link": "https://t.me/S_I_O24",
      "badge": null,
      "attributes": null,
      "community": null,
      "last_checked_at": null,
      "created_at": "2026-09-11T18:11:26Z",
      "bids_count": 0,
      "highest_bid": null
    }
  ],
  "has_more": true,
  "next_offset": 1
}
هدرهای پاسخ
x-request-id: req_D0ULDFoPAimc9UX9axr4
x-ratelimit-limit: 60
x-ratelimit-remaining: 48
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-* برمی‌گردد — جزئیات.