StardDevelopersداشبورد

فهرست خدمات کانال

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

همه‌ی خدمات رشد کانال و گروه تلگرام که از API قابل سفارش‌اند، با نوع ورودی (post، channel یا bot)، واحد، حداقل/حداکثر تعداد، چند قیمت نمونه و قابلیت‌های هر خدمت در features: reaction_picker، custom_comments، guarantee_options، post_count_options و drip_feed.

  • reactions ری‌اکشن پست (با انتخاب دقیق ایموجی) · views بازدید پست · premium_views بازدید پریمیوم
  • auto_views بازدید خودکار پست‌های بعدی · last_views بازدید چند پست آخر
  • members ممبر · premium_members ممبر پریمیوم (هر دو با سطح ضمانت)
  • bot_start استارت ربات · story_views بازدید استوری · poll_votes رأی نظرسنجی
  • share فوروارد · future_share فوروارد خودکار پست‌های بعدی
  • comments کامنت · custom_comments کامنت با متن دلخواه · future_comments کامنت خودکار پست‌های بعدی

درخواست

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

نمونه

curl "https://stard-market.ir/api/v1/services" \
  -H "Authorization: Bearer $STARD_API_KEY"
پاسخ — 200
{
  "object": "list",
  "enabled": true,
  "data": [
    {
      "object": "service",
      "id": "views",
      "name": "بازدید پست",
      "emoji": "👁",
      "input": "post",
      "input_example": "https://t.me/channel/123",
      "unit": "بازدید",
      "min_quantity": 1,
      "max_quantity": 100000000,
      "from_price": 9000,
      "currency": "IRT",
      "price_samples": [
        {
          "quantity": 100,
          "amount": 9000,
          "unit_price": 90
        },
        {
          "quantity": 500,
          "amount": 11000,
          "unit_price": 22
        },
        {
          "quantity": 1000,
          "amount": 22000,
          "unit_price": 22
        },
        {
          "quantity": 5000,
          "amount": 110000,
          "unit_price": 22
        }
      ],
      "guarantee_days": null,
      "features": {
        "reaction_picker": false,
        "custom_comments": false,
        "guarantee_options": false,
        "post_count_options": false,
        "drip_feed": true,
        "auto_refund_undelivered": true
      }
    },
    {
      "object": "service",
      "id": "auto_views",
      "name": "بازدید خودکار پست‌های بعدی",
      "emoji": "🔮",
      "input": "channel",
      "input_example": "@channel",
      "unit": "بازدید هر پست",
      "min_quantity": 1,
      "max_quantity": 10000000,
      "from_price": 20000,
      "currency": "IRT",
      "price_samples": [
        {
          "quantity": 100,
          "amount": 20000,
          "unit_price": 200
        },
        {
          "quantity": 500,
          "amount": 20000,
          "unit_price": 40
        },
        {
          "quantity": 1000,
          "amount": 40000,
          "unit_price": 40
        },
        {
          "quantity": 5000,
          "amount": 199000,
          "unit_price": 40
        }
      ],
      "guarantee_days": null,
      "features": {
        "reaction_picker": false,
        "custom_comments": false,
        "guarantee_options": false,
        "post_count_options": true,
        "drip_feed": false,
        "auto_refund_undelivered": true
      }
    },
    {
      "object": "service",
      "id": "last_views",
      "name": "بازدید پست‌های آخر",
      "emoji": "🗂",
      "input": "channel",
      "input_example": "@channel",
      "unit": "بازدید هر پست",
      "min_quantity": 1,
      "max_quantity": 100000000,
      "from_price": 20000,
      "currency": "IRT",
      "price_samples": [
        {
          "quantity": 100,
          "amount": 20000,
          "unit_price": 200
        },
        {
          "quantity": 500,
          "amount": 20000,
          "unit_price": 40
        },
        {
          "quantity": 1000,
          "amount": 30000,
          "unit_price": 30
        },
        {
          "quantity": 5000,
          "amount": 149000,
          "unit_price": 30
        }
      ],
      "guarantee_days": null,
      "features": {
        "reaction_picker": false,
        "custom_comments": false,
        "guarantee_options": false,
        "post_count_options": true,
        "drip_feed": false,
        "auto_refund_undelivered": true
      }
    }
  ],
  "total": 15
}
هدرهای پاسخ
content-type: application/json
x-request-id: req_7KzsoYUYlMTq8KL25ErV
x-ratelimit-limit: 1000
x-ratelimit-remaining: 999

خطاها

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

محدودیت نرخ

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