Chuyển đến nội dung

API SMM Panel: Dịch vụ, đơn hàng, trạng thái và số dư

API của SMMHO dùng định dạng API v2 phổ biến ở các SMM panel. Gửi một yêu cầu POST đến một địa chỉ, chọn tác vụ bằng giá trị action và nhận phản hồi JSON.

Thông tin cơ bản về API

Endpoint
POST https://smmho.com/api/v2
Định dạng yêu cầu
application/x-www-form-urlencoded hoặc application/json
Xác thực
Khóa API của bạn trong trường key. Tạo khóa ở trang tài khoản sau khi đăng nhập
Phản hồi
JSON. Yêu cầu thất bại trả về lý do trong trường error
Giới hạn tần suất
300 yêu cầu mỗi phút cho mỗi khóa
Tạo khóa APITạo khóa API của bạn ở trang tài khoản sau khi đăng nhập.
curl https://smmho.com/api/v2 \  -d "key=YOUR_API_KEY" \  -d "action=add" -d "service=9340" \  -d "link=https://instagram.com/me" \  -d "quantity=1000"
// { "order": "TT5M-CA9L" }

Các action của API SMM panel

action=servicesDanh sách dịch vụ

Trả về mọi dịch vụ kèm mã, tên, danh mục, giá mỗi 1.000, số lượng tối thiểu và tối đa, và dịch vụ có bảo hành hay không.

Tham số
TênMô tả
keyKhóa API
actionservices

Ví dụ phản hồi

[
  {
    "service": 9340,
    "name": "Instagram Followers, 30-day refill",
    "type": "Default",
    "category": "Instagram Followers",
    "rate": "2.2470",
    "min": 50,
    "max": 75000,
    "refill": true,
    "cancel": true
  }
]

action=addĐơn mới

Đặt đơn với mã dịch vụ, liên kết và số lượng. Số tiền được trừ vào số dư và mã đơn được trả về.

Tham số
TênMô tả
keyKhóa API
actionadd
serviceMã dịch vụ
linkLiên kết tài khoản hoặc bài viết
quantitySố lượng (trong khoảng tối thiểu và tối đa của dịch vụ)

Ví dụ phản hồi

{
  "order": "TT5M-CA9L"
}

action=statusTrạng thái đơn

Trả về số tiền, số đếm ban đầu, trạng thái và số lượng còn lại của một mã đơn (order) hoặc tối đa 100 mã đơn ngăn cách bằng dấu phẩy (orders).

Tham số
TênMô tả
keyKhóa API
actionstatus
orderMột mã đơn
ordersNhiều mã đơn (ngăn cách bằng dấu phẩy, tối đa 100)

Ví dụ phản hồi

{
  "charge": "2.2470",
  "start_count": 0,
  "status": "Pending",
  "remains": 1000,
  "currency": "USD"
}

action=balanceSố dư

Trả về số dư hiện tại và loại tiền tệ của bạn.

Tham số
TênMô tả
keyKhóa API
actionbalance

Ví dụ phản hồi

{
  "balance": "100.0000",
  "currency": "USD"
}

action=cancelHủy đơn

Hủy các đơn đang chờ. Số tiền được trả về số dư của bạn.

Tham số
TênMô tả
keyKhóa API
actioncancel
ordersCác mã đơn (ngăn cách bằng dấu phẩy, tối đa 100)

Ví dụ phản hồi

[
  {
    "order": "TT5M-CA9L",
    "cancel": 1
  }
]

action=refillYêu cầu bảo hành

Yêu cầu bảo hành cho đơn đã hoàn tất hoặc đơn một phần còn trong thời hạn bảo hành. Mã yêu cầu được trả về.

Tham số
TênMô tả
keyKhóa API
actionrefill
orderMã đơn

Ví dụ phản hồi

{
  "refill": "RK7QM-2XWD"
}

Các giá trị trạng thái đơn

Pending
Chưa bắt đầu, có thể hủy
In progress
Đang được giao
Completed
Đã giao đủ
Partial
Giao được một phần. Phần chưa giao được trả về số dư
Canceled
Đã hủy. Số tiền được trả về số dư

Lỗi API

Invalid API key
Khóa sai hoặc đã bị thay bằng khóa mới
Invalid service
Không có dịch vụ với mã đó
Invalid link
Không phải địa chỉ công khai bắt đầu bằng https://
Quantity out of range
Số lượng nằm ngoài mức tối thiểu và tối đa của dịch vụ
Not enough funds on balance
Số dư của bạn quá thấp
Too many requests
Đã chạm giới hạn tần suất. Hãy gửi lại sau ít phút
Refill already requested
Đơn này đã có một yêu cầu bảo hành đang mở
Refill is not available for this order
Dịch vụ không có bảo hành hoặc đã hết thời hạn bảo hành