مستندات توسعه‌دهندگان

API smmto.com

سرویس‌های ما را مستقیماً در پلتفرم خود با REST API قدرتمند ما یکپارچه کنید. سریع، قابل اعتماد و آسان برای پیاده‌سازی. ابزار رشد یا پنل ریزفروش خود را بسازید.

آپتایم 99.9%
زمان پاسخ <200ms
حجم 50M+
دریافت کلید API مشاهده در GitHub

1. شروع کار

API ما بر اساس REST است. از کدهای پاسخ HTTP استاندارد، احراز هویت و متدها استفاده می‌کند. همه درخواست‌ها به آدرس پایه ارسال شوند و پاسخ JSON برگردانده می‌شود.

آدرس پایه: https://smmto.com/api/v2

2. احراز هویت

برای احراز هویت، پارامتر `key` با کلید API منحصربه‌فرد خود را در هر درخواست قرار دهید. کلید API در داشبورد حساب شماست.

POST https://smmto.com/api/v2
Content-Type: application/json

{
  "key": "your-api-key-here",
  "action": "services"
}

کلید API را محرمانه نگه دارید. آن را در مخازن عمومی، کد سمت کلاینت یا مستندات منتشر نکنید. در صورت نشت، بلافاصله بازنشانی کنید.

3. ثبت سفارش

POST /api/v2

سفارش جدید برای هر سرویس شبکه اجتماعی موجود در پلتفرم ثبت کنید.

پارامتر نوع الزامی توضیحات
keystringYesYour unique API key
actionstringYes"add"
serviceintegerYesService ID (from Services List)
linkstringYesTarget URL (e.g. Channel link)
quantityintegerYesTotal quantity to deliver

نمونه درخواست

{
  "key": "your-api-key",
  "action": "add",
  "service": 1,
  "link": "https://t.me/yourchannel",
  "quantity": 1000
}

نمونه پاسخ

{
  "order": 23501,
  "status": "success"
}

4. وضعیت سفارش

POST /api/v2

وضعیت و پیشرفت سفارش قبلی را بررسی کنید.

پارامتر نوع الزامی توضیحات
keystringYesYour API key
actionstringYes"status"
orderintegerYesThe ID of the order
 
{
  "charge": "0.5000",
  "start_count": "1200",
  "status": "In Progress",
  "remains": "450",
  "currency": "USD"
}

5. سفارش‌های چندگانه

POST /api/v2

با اندپوینت bulk تا ۱۰۰ سفارش را در یک درخواست API ثبت کنید.

{
  "key": "your-api-key",
  "action": "add_bulk",
  "orders": [
    { "service": 1, "link": "link_1", "quantity": 100 },
    { "service": 2, "link": "link_2", "quantity": 250 }
  ]
}

6. Cancel Order

POST /api/v2

Cancel a pending or in-progress order by order ID.

{
  "key": "your-api-key",
  "action": "cancel",
  "order": 23501
}

7. Refill Order

POST /api/v2

Request a refill for eligible orders that dropped below the guaranteed level.

{
  "key": "your-api-key",
  "action": "refill",
  "order": 23501
}

8. Services List

POST /api/v2

Retrieve the full list of available services, rates, min/max quantities, and metadata.

{
  "key": "your-api-key",
  "action": "services"
}

9. کدهای خطا

API از کدهای وضعیت HTTP استاندارد برای موفقیت یا خطا استفاده می‌کند.

کد پیام توضیحات
400Invalid requestMissing or invalid parameters
401Invalid API keyAuthentication failed
404Service not foundInvalid service ID
429Rate limit exceededToo many requests
500Internal errorServer-side error

10. Rate Limits

API requests are limited to 100 requests per minute per API key. Exceeding this limit returns HTTP 429. Contact support for higher throughput on reseller plans.

11. SDK و کتابخانه‌ها

12. Changelog

v2.0 — Unified REST endpoint at /api/v2 with bulk orders, refill status, and improved error responses.

متدهای API پنل

Service list

POST /api/v2 services
پارامتر توضیحات
key Your API key
action services

نمونه پاسخ

[
    {
        "service": 1,
        "name": "Followers",
        "type": "Default",
        "category": "First Category",
        "rate": "0.90",
        "min": "50",
        "max": "10000",
        "refill": true,
        "cancel": true
    },
    {
        "service": 2,
        "name": "Comments",
        "type": "Custom Comments",
        "category": "Second Category",
        "rate": "8",
        "min": "10",
        "max": "1500",
        "refill": false,
        "cancel": true
    }
]

Add order

POST /api/v2 add

نمونه پاسخ

{
    "order": 23501
}

Order status

POST /api/v2 status
پارامتر توضیحات
key Your API key
action status
order Order ID

نمونه پاسخ

{
    "charge": "0.27819",
    "start_count": "3572",
    "status": "Partial",
    "remains": "157",
    "currency": "USD"
}

Multiple orders status

POST /api/v2 multi_status
پارامتر توضیحات
key Your API key
action status
orders Order IDs (separated by a comma, up to 100 IDs)

نمونه پاسخ

{
    "1": {
        "charge": "0.27819",
        "start_count": "3572",
        "status": "Partial",
        "remains": "157",
        "currency": "USD"
    },
    "10": {
        "error": "Incorrect order ID"
    },
    "100": {
        "charge": "1.44219",
        "start_count": "234",
        "status": "In progress",
        "remains": "10",
        "currency": "USD"
    }
}

Create refill

POST /api/v2 refill
پارامتر توضیحات
key Your API key
action refill
order Order ID

نمونه پاسخ

{
    "refill": "1"
}

Create multiple refill

POST /api/v2 multi_refill
پارامتر توضیحات
key Your API key
action refill
orders Order IDs (separated by a comma, up to 100 IDs)

نمونه پاسخ

[
    {
        "order": 1,
        "refill": 1
    },
    {
        "order": 2,
        "refill": 2
    },
    {
        "order": 3,
        "refill": {
            "error": "Incorrect order ID"
        }
    }
]

Get refill status

POST /api/v2 refill_status
پارامتر توضیحات
key Your API key
action refill_status
refill Refill ID

نمونه پاسخ

{
    "status": "Completed"
}

Get multiple refill status

POST /api/v2 multi_refill_status
پارامتر توضیحات
key Your API key
action refill_status
refills Refill IDs (separated by a comma, up to 100 IDs)

نمونه پاسخ

[
    {
        "refill": 1,
        "status": "Completed"
    },
    {
        "refill": 2,
        "status": "Rejected"
    },
    {
        "refill": 3,
        "status": {
            "error": "Refill not found"
        }
    }
]

Create cancel

POST /api/v2 cancel
پارامتر توضیحات
key Your API key
action cancel
orders Order IDs (separated by a comma, up to 100 IDs)

نمونه پاسخ

[
    {
        "order": 9,
        "cancel": {
            "error": "Incorrect order ID"
        }
    },
    {
        "order": 2,
        "cancel": 1
    }
]

User balance

POST /api/v2 balance
پارامتر توضیحات
key Your API key
action balance

نمونه پاسخ

{
    "balance": "100.84292",
    "currency": "USD"
}
نمونه کد PHP
چت زنده پشتیبانی ۲۴/۷