وثائق المطورين

واجهة smmto.com API

ادمج خدماتنا مباشرة في منصتك عبر REST API القوية. سريعة وموثوقة وسهلة التنفيذ. ابنِ أداة نموك أو لوحة الموزع اليوم.

وقت التشغيل 99.9%
وقت الاستجابة <200ms
الحجم 50M+
الحصول على مفتاح API عرض على GitHub

1. البدء

واجهة API مبنية على مبادئ REST. تستخدم رموز استجابة HTTP القياسية والمصادقة والأفعال. تُرسل جميع الطلبات إلى عنوان URL الأساسي وتعيد استجابات بصيغة JSON.

عنوان URL الأساسي: https://smmto.com/api/v2

2. المصادقة

لمصادقة طلباتك، يجب تضمين مفتاح API الفريد كمعامل `key` في كل طلب. يمكنك العثور على المفتاح في لوحة حسابك.

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

الكفاءة مهمة. استخدم نقطة النهاية الجماعية لتقديم حتى 100 طلب في استدعاء 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. رموز الأخطاء

تستخدم الواجهة رموز حالة 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.

طرق Panel 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
دردشة مباشرة دعم على مدار الساعة