Trang chủ / Nhà phát triển / Orders API
Orders API
Thêm smm.guide vào panel của bạn như một nhà cung cấp. Mỗi tuyến bạn tạo trong tài khoản là một dịch vụ có ID riêng: panel của bạn gửi đơn đến ID đó, và tuyến chuyển đơn cho nhà cung cấp đầu tiên của bạn có thể nhận đơn.
Ba bước
Định dạng này là định dạng các SMM panel vẫn dùng với nhau, nên không cần lập trình gì.
https://smm.guide/api/v2 và khóa. Nhập dịch vụ: các tuyến của bạn sẽ có mặt cùng ID, giá và giới hạn.Định dạng yêu cầu
| Phương thức HTTP | POST |
| API URL | https://smm.guide/api/v2 |
| Body | application/x-www-form-urlencoded, hoặc JSON với Content-Type: application/json. A multipart/form-data body cũng được đọc, đây là thứ PHP gửi khi cURL nhận một mảng |
| Phản hồi | JSON, luôn với HTTP 200, kể cả với body không đọc được hoặc yêu cầu quá lớn. Lỗi có dạng {"error": "…"} |
| Tiền | Đô la Mỹ. Giá tính cho mỗi 1.000 |
Danh sách dịch vụ
Các tuyến của bạn có thể nhận đơn ngay lúc này. Tuyến đã tắt, hoặc có mọi bước đều bị loại, sẽ không được liệt kê.
| Tham số | Mô tả |
|---|---|
key | Khóa API của bạn |
action | services |
Phản hồi
[
{
"service": 85725095,
"name": "TG views, main",
"type": "Default",
"category": "Telegram views",
"rate": "0.0018",
"min": "10",
"max": "1000000",
"refill": false,
"cancel": true,
"dripfeed": false
}
]rate là giá cao nhất trong các bước của tuyến có thể nhận đơn, kể cả các bước đang tạm bỏ qua (panel hôm nay ngừng hoạt động thì mai có thể trở lại), nên một đơn hàng không bao giờ đắt hơn mức giá panel của bạn đã nhập. min và max là phạm vi rộng nhất mà các bước đang hoạt động cùng đáp ứng; số lượng chỉ phù hợp với một số bước sẽ được chuyển đến một trong các bước đó. refill và cancel là true khi mọi bước như vậy đều hỗ trợ.
Tuyến đã tắt, hoặc không có bước nào hoạt động được, sẽ bị loại khỏi danh sách này cho đến khi hoạt động trở lại. Panel tự động đồng bộ dịch vụ sẽ tắt dịch vụ đó bên phía mình trong cùng khoảng thời gian, và đó là điều bạn muốn: các đơn hàng của nó sẽ bị từ chối.
Thêm đơn hàng
| Tham số | Mô tả |
|---|---|
key | Khóa API của bạn |
action | add |
service | ID của tuyến, tám chữ số |
link | Liên kết đến trang, bài đăng hoặc hồ sơ |
quantity | Số lượng cần |
Phản hồi
{
"order": 23501
}
Không nơi nào nhận đơn
{
"error": "No step of this route accepted the order. …"
}Mã đơn giữ nguyên trong suốt vòng đời của đơn hàng, dù nhà cung cấp nào cuối cùng thực hiện. Tuyến nhận liên kết và số lượng; nhỏ giọt, bình luận và các trường bổ sung khác sẽ bị từ chối.
Trạng thái đơn hàng
| Tham số | Mô tả |
|---|---|
key | Khóa API của bạn |
action | status |
order | ID đơn hàng |
Phản hồi
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| Tham số | Mô tả |
|---|---|
key | Khóa API của bạn |
action | status |
orders | Các ID đơn hàng phân cách bằng dấu phẩy, tối đa 100 |
Phản hồi
{
"23501": {
"charge": "0.0045",
"start_count": "3572",
"status": "Completed",
"remains": "0",
"currency": "USD"
},
"99": { "error": "Incorrect order ID" }
}| Trạng thái | Ý nghĩa |
|---|---|
Pending | Đã được nhà cung cấp nhận và chưa bắt đầu. Cũng là đơn hàng mà nhà cung cấp không trả lời rõ ràng: tuyến dừng ở đó cho đến khi bạn kiểm tra trong tài khoản. |
In progress, Processing | Một nhà cung cấp đang thực hiện, hoặc đơn hàng đang được chuyển sang bước tiếp theo. |
Completed | Đã giao đầy đủ. |
Partial | Đã giao một phần; remains là phần chưa giao. Số liệu tính tổng những gì mọi bước đã giao: khi một bước giao một phần và phần còn lại bị hủy ở bước tiếp theo, đơn hàng ở trạng thái Partial, không phải Canceled. Nhà cung cấp quyết định việc hoàn lại phần tiền còn lại. |
Canceled | Không giao được gì, và không bước nào khác nhận đơn. charge cho biết số tiền vẫn bị trừ, nếu có. |
charge là số tiền các nhà cung cấp đã tính cho đơn này, bằng đô la theo tỷ giá ngày đặt đơn. start_count lấy từ nhà cung cấp đã bắt đầu đơn.
Số dư
smm.guide không giữ tiền của bạn. Con số này là tổng số dư của bạn trên các panel đứng sau các tuyến, tính bằng đô la.
| Tham số | Mô tả |
|---|---|
key | Khóa API của bạn |
action | balance |
Phản hồi
{
"balance": "126.1375",
"currency": "USD"
}Hủy
Được chuyển đến nhà cung cấp đang giữ đơn, nếu dịch vụ của họ hỗ trợ hủy. Đơn bạn đã hủy sẽ không bao giờ được chuyển sang bước tiếp theo.
| Tham số | Mô tả |
|---|---|
key | Khóa API của bạn |
action | cancel |
orders | Các ID đơn hàng phân cách bằng dấu phẩy, tối đa 100 |
Phản hồi
[
{ "order": 23501, "cancel": 1 },
{ "order": 23502, "cancel": { "error": "The order is already finished" } }
]Refill
Được chuyển đến nhà cung cấp đã giao đơn. Yêu cầu refill mang chính mã của đơn hàng.
| Tham số | Mô tả |
|---|---|
key | Khóa API của bạn |
action | refill |
order | ID đơn hàng. Hoặc orders: nhiều mã, phân cách bằng dấu phẩy |
Phản hồi, một đơn
{ "refill": "23501" }
Phản hồi, nhiều đơn
[
{ "order": 23501, "refill": 23501 },
{ "order": 23502, "refill": { "error": "…" } }
]| Tham số | Mô tả |
|---|---|
key | Khóa API của bạn |
action | refill_status |
refill | ID refill. Hoặc refills: nhiều mã, phân cách bằng dấu phẩy |
Phản hồi
{ "status": "Completed" }Tuyến xử lý đơn hàng như thế nào
- Các bước được thử theo thứ tự của bạn, hoặc bước rẻ nhất đang hoạt động trước. Bạn chọn cách nào trong cài đặt tuyến.
- Một bước bị bỏ qua khi panel của bước đó không phản hồi, số dư hoặc giới hạn hằng ngày không đủ cho đơn, số lượng nằm ngoài phạm vi nhận, giá cao hơn mức giới hạn bạn đặt, hoặc với mức giá đó đơn sẽ vượt giới hạn hằng ngày của chính tuyến. Bước đó sẽ tự quay lại.
- Một bước bị loại khi dịch vụ của nó rời khỏi bảng giá, hoặc panel bắt đầu bán thứ khác dưới cùng ID. Các bước khác vẫn hoạt động, và bạn sẽ được thông báo.
- Bị từ chối thì đơn được chuyển tiếp. Khi panel trả lời và từ chối, chưa có khoản nào bị trừ, nên bước tiếp theo sẽ được thử.
- Không có câu trả lời rõ ràng thì tuyến dừng. Hết thời gian chờ hoặc câu trả lời lỗi không cho biết đơn có tồn tại hay không. Chuyển tiếp có thể khiến đơn được giao và bị trừ tiền hai lần, nên tuyến dừng lại và bạn kiểm tra đơn đó trong tài khoản.
- Mỗi liên kết một đơn đang chạy. Khi một đơn cho một liên kết đang chạy trên tuyến, đơn thứ hai cho cùng liên kết sẽ bị từ chối, giống như cách các nhà cung cấp vẫn làm.
- Đơn bị hủy trước khi giao cũng có thể được chuyển tiếp, nếu bạn đã bật tùy chọn đó. Phần chưa giao của đơn hoàn thành một phần chỉ được chuyển tiếp nếu bạn yêu cầu.
Lỗi
| Lỗi | Ý nghĩa |
|---|---|
Invalid API key | Khóa sai, đã bị thay hoặc đã bị thu hồi. |
This key is limited to certain addresses… | Yêu cầu đến từ một địa chỉ không có trong danh sách của khóa. |
Incorrect request | Không xác định action. |
Incorrect service ID | Không có tuyến nào của bạn có ID này. Tuyến bạn đã xóa vẫn giữ số của nó, và số đó không bao giờ được cấp cho tuyến khác. |
Incorrect order ID | Không có đơn nào của bạn có mã này. |
Link is required, Quantity is required | Một trường của add bị thiếu hoặc không phải là số. |
A route takes a link and a quantity only | Yêu cầu có kèm nhỏ giọt, bình luận hoặc trường bổ sung khác. |
This route is switched off | Hãy bật trong tài khoản của bạn. |
This route already has an order for this link… | Hãy chờ đến khi đơn đang chạy hoàn tất. |
No step of this route can take this order right now. … | Mọi bước đều bị bỏ qua trước khi có gì được gửi đi. Nội dung lỗi nêu tên từng panel và lý do. |
No step of this route accepted the order. … | Mọi bước được hỏi đều từ chối. Không có khoản nào bị trừ. |
Too many requests… | Vượt giới hạn bên dưới. Hãy chờ một phút. |
Ví dụ
cURL
curl https://smm.guide/api/v2 \ -d key=sgo_… \ -d action=add \ -d service=85725095 \ -d link=https://t.me/channel/123 \ -d quantity=1000
PHP
function smmguide(array $post) {
$ch = curl_init('https://smm.guide/api/v2');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => http_build_query(
['key' => 'sgo_…'] + $post),
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 60,
]);
$out = json_decode(curl_exec($ch), true);
curl_close($ch);
return $out;
}
$order = smmguide(['action' => 'add',
'service' => 85725095,
'link' => 'https://t.me/channel/123',
'quantity' => 1000]);
Lệnh add luôn được trả lời trong vòng 30 giây. Tuyến có thể hỏi lần lượt nhiều nhà cung cấp; mỗi nhà cung cấp nhận phần thời gian còn lại, và nhà cung cấp không thể chờ kịp sẽ không được hỏi. Nếu nhà cung cấp cuối cùng được hỏi chưa trả lời khi hết thời gian, bạn nhận được mã đơn với trạng thái Pending, và tuyến dừng ở đó cho đến khi biết câu trả lời. Phần lớn đơn hàng được trả lời trong một hoặc hai giây.
Giới hạn và bảo mật
- 300 yêu cầu mỗi phút cho mỗi khóa, trong đó 120 là đơn hàng. Tối đa 100 mã đơn trong một
statuslệnh gọi. - Khóa chỉ hiển thị một lần và được lưu dưới dạng dấu vân tay. Cả bạn và chúng tôi đều không thể đọc lại. Thay khóa sẽ vô hiệu hóa khóa cũ ngay lập tức.
- Địa chỉ được phép. Nhập địa chỉ máy chủ panel của bạn trong tài khoản, và khóa sẽ không hoạt động từ nơi nào khác.
- ID tuyến không phải bí mật và không cần giữ bí mật. ID chỉ hoạt động cùng với khóa của tài khoản sở hữu tuyến.
- Các giới hạn của bạn vẫn áp dụng. Giới hạn hằng ngày của từng panel, giới hạn hằng ngày của chính tuyến và đơn lớn nhất của tuyến áp dụng cho đơn đến qua API giống hệt như đơn bạn đặt thủ công.
- Tiền không bao giờ đi qua smm.guide. Mỗi đơn hàng được thanh toán từ số dư của bạn trên panel nhận đơn. Hoàn tiền và tranh chấp là việc giữa bạn và panel đó.
Bạn cần đọc danh mục?
Panel, Trust Score và giá trực tiếp có API riêng, cùng máy chủ MCP cho trợ lý AI.