Tài liệu dành cho nhà phát triển

API smmto.com

Tích hợp dịch vụ của chúng tôi trực tiếp vào nền tảng của bạn bằng REST API mạnh mẽ. Nhanh, đáng tin cậy và dễ triển khai. Xây dựng công cụ tăng trưởng hoặc panel đại lý ngay hôm nay.

Thời gian hoạt động 99.9%
Thời gian phản hồi <200ms
Khối lượng 50M+
Lấy khóa API Xem trên GitHub

1. Bắt đầu

API của chúng tôi được xây dựng trên nguyên tắc REST. Sử dụng mã phản hồi HTTP chuẩn, xác thực và phương thức. Mọi yêu cầu gửi tới URL gốc và trả về phản hồi dạng JSON.

URL gốc: https://smmto.com/api/v2

2. Xác thực

Để xác thực yêu cầu, bạn phải kèm khóa API duy nhất dưới dạng tham số `key` trong mọi yêu cầu. Bạn có thể tìm khóa API trong bảng điều khiển tài khoản.

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

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

Giữ bí mật khóa API. Không chia sẻ trong kho công khai, mã phía client hoặc tài liệu. Nếu bị lộ, hãy tạo lại ngay.

3. Thêm đơn hàng

POST /api/v2

Đặt đơn mới cho bất kỳ dịch vụ mạng xã hội nào có trên nền tảng của chúng tôi.

Tham số Kiểu Bắt buộc Mô tả
keystringYesYour unique API key
actionstringYes"add"
serviceintegerYesService ID (from Services List)
linkstringYesTarget URL (e.g. Channel link)
quantityintegerYesTotal quantity to deliver

Ví dụ yêu cầu

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

Ví dụ phản hồi

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

4. Trạng thái đơn hàng

POST /api/v2

Kiểm tra trạng thái và tiến độ của đơn đã đặt trước đó.

Tham số Kiểu Bắt buộc Mô tả
keystringYesYour API key
actionstringYes"status"
orderintegerYesThe ID of the order
 
{
  "charge": "0.5000",
  "start_count": "1200",
  "status": "In Progress",
  "remains": "450",
  "currency": "USD"
}

5. Nhiều đơn hàng

POST /api/v2

Hiệu quả là then chốt. Dùng endpoint hàng loạt để đặt tối đa 100 đơn trong một lần gọi 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. Mã lỗi

API dùng mã trạng thái HTTP chuẩn để báo thành công hoặc thất bại.

Mã Thông báo Mô tả
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 & thư viện

12. Changelog

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

Phương thức Panel API

Service list

POST /api/v2 services
Tham số Mô tả
key Your API key
action services

Ví dụ phản hồi

[
    {
        "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

Ví dụ phản hồi

{
    "order": 23501
}

Order status

POST /api/v2 status
Tham số Mô tả
key Your API key
action status
order Order ID

Ví dụ phản hồi

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

Multiple orders status

POST /api/v2 multi_status
Tham số Mô tả
key Your API key
action status
orders Order IDs (separated by a comma, up to 100 IDs)

Ví dụ phản hồi

{
    "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
Tham số Mô tả
key Your API key
action refill
order Order ID

Ví dụ phản hồi

{
    "refill": "1"
}

Create multiple refill

POST /api/v2 multi_refill
Tham số Mô tả
key Your API key
action refill
orders Order IDs (separated by a comma, up to 100 IDs)

Ví dụ phản hồi

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

Get refill status

POST /api/v2 refill_status
Tham số Mô tả
key Your API key
action refill_status
refill Refill ID

Ví dụ phản hồi

{
    "status": "Completed"
}

Get multiple refill status

POST /api/v2 multi_refill_status
Tham số Mô tả
key Your API key
action refill_status
refills Refill IDs (separated by a comma, up to 100 IDs)

Ví dụ phản hồi

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

Create cancel

POST /api/v2 cancel
Tham số Mô tả
key Your API key
action cancel
orders Order IDs (separated by a comma, up to 100 IDs)

Ví dụ phản hồi

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

User balance

POST /api/v2 balance
Tham số Mô tả
key Your API key
action balance

Ví dụ phản hồi

{
    "balance": "100.84292",
    "currency": "USD"
}
Ví dụ mã PHP
Chat trực tiếp Hỗ trợ 24/7