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ì.

1Tạo tuyếnTài khoản, Orders desk, Tuyến. Chọn dịch vụ tuyến cung cấp và thêm tối đa năm dịch vụ cùng loại từ các panel bạn đã kết nối.
2Tạo khóaOrders desk, Orders API. Khóa chỉ hiển thị một lần. Bạn có thể giới hạn khóa theo địa chỉ máy chủ panel của bạn.
3Thêm nhà cung cấp trong panel của bạnAPI URL 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 HTTPPOST
API URLhttps://smm.guide/api/v2
Bodyapplication/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ồiJSON, 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ả
keyKhóa API của bạn
actionservices

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ả
keyKhóa API của bạn
actionadd
serviceID của tuyến, tám chữ số
linkLiên kết đến trang, bài đăng hoặc hồ sơ
quantitySố 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ả
keyKhóa API của bạn
actionstatus
orderID đơn hàng

Phản hồi

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
Tham sốMô tả
keyKhóa API của bạn
actionstatus
ordersCá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, ProcessingMộ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.
CanceledKhô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ả
keyKhóa API của bạn
actionbalance

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ả
keyKhóa API của bạn
actioncancel
ordersCá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ả
keyKhóa API của bạn
actionrefill
orderID đơ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ả
keyKhóa API của bạn
actionrefill_status
refillID 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 keyKhó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 requestKhông xác định action.
Incorrect service IDKhô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 IDKhông có đơn nào của bạn có mã này.
Link is required, Quantity is requiredMộ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 onlyYê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 offHã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 status lệ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.