API ویژهٔ ریسلرها

یک اندپوینت، یک فرم با فیلدهای key و action. سازگار با API v2 استاندارد پنل‌های SMM — ماژول‌های آمادهٔ فروشگاه‌ها و سیستم‌های صورت‌حساب بدون تغییر متصل می‌شوند.
شروع سریع
آدرس
https://telegos.app/api/v2
متد
POST
فرمت بدنه
application/x-www-form-urlencoded
پاسخ
JSON، همیشه با وضعیت 200
کلید در فیلد key در بدنهٔ درخواست ارسال می‌شود — هدر Authorization اینجا استفاده نمی‌شود. حساب کاربری شما با توکن جداگانه‌ای کار می‌کند، بنابراین بازنشانی کلید نشست مرورگر شما را پایان نمی‌دهد.
فهرست سرویس‌ها
کل لیست قیمت را برمی‌گرداند: id سرویس برای action=add، قیمت هر 1000 عدد و محدودهٔ تعداد.
فیلدمقدار
keyکلید شما
actionservices
درخواست
curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=services
پاسخ
[
  {
    "service": 101,
    "name": "Telegram Members · CIS",
    "type": "Default",
    "category": "Telegram Members",
    "rate": "0.90",
    "min": "50",
    "max": "10000",
    "refill": true,
    "cancel": true
  }
]
ثبت سفارش
هزینه را فوراً از موجودی کسر می‌کند و شمارهٔ سفارش را برمی‌گرداند.
فیلدمقدار
keyکلید شما
actionadd
serviceid سرویس از action=services
linkلینک کانال، پست یا پروفایل
quantityتعداد سفارش در محدودهٔ min…max
درخواست
curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=add \
  -d service=101 \
  -d link=https://t.me/example \
  -d quantity=500
پاسخ
{
  "order": 23501
}
سفارش ارسال تدریجی (drip-feed)
همان فیلدها به‌علاوهٔ دو فیلد دیگر: تعداد اجراها و فاصلهٔ بین آن‌ها. در اینجا quantity تعداد یک اجراست و مبلغ همهٔ اجراها کسر می‌شود.
فیلدمقدار
runsتعداد اجراها
intervalفاصلهٔ بین اجراها به دقیقه
درخواست
curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=add \
  -d service=101 \
  -d link=https://t.me/example \
  -d quantity=100 \
  -d runs=5 \
  -d interval=60
پاسخ
{
  "order": 23502
}
وضعیت سفارش
start_count شمارنده در لحظهٔ شروع است و remains مقداری است که هنوز تحویل نشده.
فیلدمقدار
keyکلید شما
actionstatus
orderشمارهٔ سفارش
درخواست
curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=status \
  -d order=23501
پاسخ
{
  "charge": "0.4500",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
وضعیت چند سفارش
حداکثر 100 شماره در هر درخواست. پاسخ یک آبجکت است که کلیدهایش شمارهٔ سفارش‌اند: شمارهٔ ناموجود با error برمی‌گردد و بقیه را مختل نمی‌کند.
فیلدمقدار
keyکلید شما
actionstatus
ordersشماره‌ها، جداشده با کاما
درخواست
curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=status \
  -d orders=23501,23502,999999
پاسخ
{
  "23501": {
    "charge": "0.4500",
    "start_count": "3572",
    "status": "Completed",
    "remains": "0",
    "currency": "USD"
  },
  "23502": {
    "charge": "0.9000",
    "start_count": "1204",
    "status": "In progress",
    "remains": "300",
    "currency": "USD"
  },
  "999999": {
    "error": "Incorrect order ID"
  }
}
جبران ریزش
در جایی در دسترس است که سرویس refill: true برگرداند. پیشرفت جبران ریزش با عملیات جداگانهٔ refill_status و بر اساس شمارهٔ آن بررسی می‌شود.
فیلدمقدار
keyکلید شما
actionrefill / refill_status
orderشمارهٔ سفارش — برای refill
refillشمارهٔ جبران ریزش — برای refill_status
درخواست
curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=refill \
  -d order=23501
پاسخ
{
  "refill": 412
}
لغو
در جایی در دسترس است که سرویس cancel: true برگرداند. مبلغ سفارش‌های لغوشده به موجودی بازمی‌گردد.
فیلدمقدار
keyکلید شما
actioncancel
ordersشماره‌ها، جداشده با کاما
درخواست
curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=cancel \
  -d orders=23501,23502
پاسخ
[
  { "order": 23501, "cancel": 1 },
  { "order": 23502, "cancel": { "error": "Incorrect order ID" } }
]
موجودی
فیلدمقدار
keyکلید شما
actionbalance
درخواست
curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=balance
پاسخ
{
  "balance": "19.61",
  "currency": "USD"
}
وضعیت سفارش‌ها
وضعیتمعنی
Pendingسفارش پذیرفته شده و در انتظار ارسال به تأمین‌کننده است
In progressدر حال انجام است
Processingسفارش در سمت تأمین‌کننده در حال پردازش است
Completedتعداد به‌طور کامل تحویل شد
Partialبخشی از تعداد تحویل شد و باقی‌مانده به موجودی بازگشت
Canceledسفارش لغو شد و مبلغ کسرشده بازگشت
خطاها
خطا با همان کد 200 برمی‌گردد و تفاوتش در وجود فیلد error است: باید بدنهٔ پاسخ را بررسی کرد، نه وضعیت آن را. در عملیات دسته‌ای، خطا داخل عنصر خودش قرار می‌گیرد و بقیه را لغو نمی‌کند.
پاسخ
{
  "error": "Incorrect request"
}