Tài liệu API
API key của bạn
Đăng nhập để tạo API key, xem các lượt script đã gọi và chọn tiền tệ API.
Bắt đầu nhanh
Chuẩn SMM API v2 — script viết cho các panel khác thường dùng được ngay, chỉ cần đổi địa chỉ và key.
- Gửi yêu cầu
POSThttps://korea.seedingthucong.com/api/v2Thân yêu cầu dạng form (application/x-www-form-urlencoded) hoặc JSON. Dùng POST, đặt key và action trong thân yêu cầu. GET cũng được, nhưng GET làm key của bạn nằm trong log máy chủ. POST mà đặt key trên địa chỉ (query string) bị coi là key sai.
- Đọc kết quả
Mọi lỗi API đều trả HTTP 200 kèm trường error; chỉ lỗi đường truyền (404, 405, 413) giữ mã HTTP thật. Không có trường error là thành công. Số tiền, số lượng trả về dạng chuỗi ký tự (VD "11900") — đổi sang số trước khi tính.
- Tiền tệ và giới hạn
Số tiền trả về bằng VND, trừ khi key được chuyển sang USD sau khi đăng nhập. Nút coin/USD ở đầu trang chỉ đổi cách trang web hiện tiền; không bao giờ ảnh hưởng tới API. Tối đa 300 yêu cầu mỗi phút cho mỗi API key.
- Thử lại mà không tạo đơn trùng
Mỗi lần gọi add là một đơn mới, trừ tiền mới. Luôn gửi ref_id riêng cho mỗi đơn. Nếu add bị hết thời gian chờ hoặc lỗi mạng, hãy đợi lâu hơn thời gian xử lý tối đa 60 giây rồi gọi status với ref_id đó — chưa có đơn mới gửi add lại. Không tự gửi lại khi đã nhận {"order": …} hoặc một lỗi nghiệp vụ.
Quy tắc kết nối khác
- status: tối đa 100 mã mỗi lần gọi, 1 lần/phút là đủ. Trạng thái cập nhật mỗi 2–30 phút. Chỉ hỏi các đơn chưa ở trạng thái cuối.
- orders=",,," (chỉ có dấu phẩy): cancel trả [], status trả {}.
- cancel trả lời theo từng đơn; một đơn cũng có thể nhận lỗi Internal error (gọi lại an toàn).
- updates: không có since_id thì mới nhất trước. Có since_id thì trả từ cũ tới mới, tối đa 100; một mục chỉ hiện sau khi tạo khoảng 10 giây.
- Hiện lại một mục đã ẩn, hoặc đổi giá riêng / đổi cấp của bạn, không được gửi lại cho script đã đi qua mục đó.
- JSON không kèm header Content-Type: tối đa 64 KB, lồng sâu tối đa 8 cấp.
Các lệnh (action)
Chọn lệnh để xem tham số, code mẫu và kết quả trả về.
action=servicesDanh sách server
Mọi server bạn dùng được, kèm giá riêng của bạn cho 1.000 đơn vị. Gọi một lần khi khởi động rồi lưu lại; không cần gọi trước mỗi đơn.
| Tên | Bắt buộc | Kiểu | Ý nghĩa | Ví dụ |
|---|---|---|---|---|
key | Có | chuỗi | API key của bạn | sk_live_… |
action | Có | chuỗi | Luôn là services | services |
Đang hiện sk_live_… — đăng nhập và tạo API key để có key của riêng bạn.
service- Mã server dùng khi đặt đơn. Mã này không bao giờ đổi và không bao giờ bị dùng lại.
name- Tên server, theo ngôn ngữ tên server bạn chọn
category- Nhóm dạng "Nền tảng - Nhóm"
type- "Default" = link + quantity. "Custom Comments" / "Mentions Custom List" = gửi danh sách trong comments (hoặc usernames), mỗi dòng một mục; số lượng = số dòng có chữ
rate- Giá của bạn cho 1.000 đơn vị, theo tiền tệ API. Tiền đơn = rate × số lượng ÷ 1000.
min · max- Số lượng nhỏ nhất / lớn nhất mỗi đơn
cancel- true = huỷ được bằng lệnh cancel
refund- true = phần chưa chạy được hoàn tiền; false = server "không huỷ, không hoàn": đã chạy thì đơn kết thúc là Completed, không hoàn tiền
refill · dripfeed- Luôn false — chưa hỗ trợ
country- Mã quốc gia 2 chữ của người tương tác (vn, th, us…), global = toàn cầu
action=addĐặt đơn
Tạo đơn mới và trừ tiền số dư ngay. Mỗi lần gọi là một đơn mới — hệ thống không chặn đơn trùng, nên luôn gửi ref_id.
| Tên | Bắt buộc | Kiểu | Ý nghĩa | Ví dụ |
|---|---|---|---|---|
key | Có | chuỗi | API key của bạn | sk_live_… |
action | Có | chuỗi | Luôn là add | add |
service | Có | số nguyên | Mã server lấy từ services | 1021 |
link | Có | chuỗi (URL) | Link cần tăng tương tác, đúng nền tảng của server | https://www.facebook.com/abc |
quantity | Có | số nguyên | Số lượng, trong khoảng min–max của server. Server Custom Comments không cần — có gửi cũng bị bỏ qua | 1000 |
comments | Không | chuỗi | Chỉ cho server Custom Comments: mỗi dòng một bình luận. Số lượng = số dòng có chữ (dòng trống không tính, dòng trùng vẫn giữ và tính tiền). Nhận cả tên usernames | Nice!\nLove it |
ref_id | Không | chuỗi ≤ 64 ký tự | Mã đơn của riêng bạn — gửi kèm để tìm lại đơn sau khi lỗi mạng | order-2291 |
Đang hiện sk_live_… — đăng nhập và tạo API key để có key của riêng bạn.
order- Mã đơn của hệ thống — lưu lại để hỏi trạng thái hoặc huỷ
action=statusTrạng thái đơn
Gửi đúng một trong ba: order (1 đơn), orders (nhiều đơn) hoặc ref_id (tìm theo mã của bạn). Chỉ hỏi các đơn chưa ở trạng thái cuối.
| Tên | Bắt buộc | Kiểu | Ý nghĩa | Ví dụ |
|---|---|---|---|---|
key | Có | chuỗi | API key của bạn | sk_live_… |
action | Có | chuỗi | Luôn là status | status |
order | Chọn 1 | số nguyên | Một mã đơn → một object | 100245 |
orders | Chọn 1 | chuỗi | Tối đa 100 mã, cách nhau dấu phẩy → object có khoá là mã đơn | 100245,100246 |
ref_id | Chọn 1 | chuỗi | ref_id bạn đã gửi → các đơn của bạn mang ref_id đó (tối đa 100 đơn mới nhất; không có → {}) | order-2291 |
Đang hiện sk_live_… — đăng nhập và tạo API key để có key của riêng bạn.
(key)- Với orders / ref_id: khoá là mã đơn dạng chuỗi. Mã sai nhận lỗi riêng, không làm hỏng cả lần gọi.
charge- Số tiền đã trừ, theo tiền tệ API
start_count- Số đếm lúc đơn bắt đầu chạy; 0 khi chưa biết
status- Một trong 5 trạng thái ở bảng bên dưới
remains- Số lượng chưa chạy
currency- Tiền tệ của charge
ref_id- ref_id bạn đã gửi; null nếu không gửi
action=cancelHuỷ đơn
Gửi yêu cầu huỷ một hoặc nhiều đơn. Kết quả theo từng đơn; một đơn lỗi không ảnh hưởng đơn khác.
| Tên | Bắt buộc | Kiểu | Ý nghĩa | Ví dụ |
|---|---|---|---|---|
key | Có | chuỗi | API key của bạn | sk_live_… |
action | Có | chuỗi | Luôn là cancel | cancel |
order | Chọn 1 | số nguyên | Một mã đơn | 100245 |
orders | Chọn 1 | chuỗi | Tối đa 100 mã, cách nhau dấu phẩy | 100245,100246 |
Đang hiện sk_live_… — đăng nhập và tạo API key để có key của riêng bạn.
order- Mã đơn
cancel- 1 = đã nhận yêu cầu. Tiền phần chưa chạy được hoàn khi đơn dừng hẳn — theo dõi bằng status (Canceled hoặc Partial).
cancel.error- Đơn này không huỷ được — xem bảng mã lỗi
action=balanceSố dư
Số dư hiện tại, theo tiền tệ API của bạn.
| Tên | Bắt buộc | Kiểu | Ý nghĩa | Ví dụ |
|---|---|---|---|---|
key | Có | chuỗi | API key của bạn | sk_live_… |
action | Có | chuỗi | Luôn là balance | balance |
Đang hiện sk_live_… — đăng nhập và tạo API key để có key của riêng bạn.
balance- Số dư hiện tại
currency- Tiền tệ API của bạn
action=updatesCập nhật server
Riêng của panel này (không có trong chuẩn SMM API v2): thay đổi của các server bạn dùng được — server mới, đổi giá, bảo trì, ngừng bán, đổi min/max, thông báo.
| Tên | Bắt buộc | Kiểu | Ý nghĩa | Ví dụ |
|---|---|---|---|---|
key | Có | chuỗi | API key của bạn | sk_live_… |
action | Có | chuỗi | Luôn là updates | updates |
since_id | Không | số nguyên | Chỉ lấy mục có id lớn hơn — gửi id lớn nhất bạn nhận được lần trước | 5119 |
Đang hiện sk_live_… — đăng nhập và tạo API key để có key của riêng bạn.
id- Mã mục, tăng dần — lưu id lớn nhất và gửi làm since_id
type- Một trong: new · price_up · price_down · maintenance · resumed · discontinued · limits_changed · announcement
service- Mã server liên quan; null với thông báo
title · body- Tiêu đề và nội dung, theo ngôn ngữ tên server bạn chọn
old · new- Mục giá: giá 1.000 đơn vị trước → sau, theo tiền tệ API, luôn dạng chuỗi. limits_changed: {"min", "max"}, luôn dạng chuỗi; loại khác: null.
created_at- Thời điểm, ISO 8601 giờ Việt Nam (+07:00)
Các trạng thái đơn
Giá trị của trường status. Hai trạng thái đầu là đang xử lý; ba trạng thái sau là cuối cùng — không đổi nữa, thôi hỏi đơn đó.
Pending | Đã nhận, chờ bắt đầu chạy. | tiếp tục hỏi |
In progress | Đang chạy — remains là số còn lại chưa chạy. | tiếp tục hỏi |
Completed | Chạy đủ số lượng, remains = 0. | cuối cùng |
Partial | Chạy thiếu; phần chưa chạy (remains) đã được hoàn tiền vào số dư. | cuối cùng |
Canceled | Đã huỷ; tiền phần chưa chạy đã hoàn (huỷ trước khi chạy = hoàn đủ). | cuối cùng |
Mã lỗi và cách xử lý
Nội dung trường error luôn bằng tiếng Anh và cố định — script có thể so sánh chuỗi.
error | Ý nghĩa | Nên làm gì |
|---|---|---|
Invalid API key | Key sai hoặc đã được thay bằng key mới. | Copy lại key ở trang này. Quá 20 key sai mỗi phút từ một IP thì IP đó bị từ chối tối đa một phút. |
Account disabled | Tài khoản của bạn đang bị khoá. | Liên hệ hỗ trợ; đừng gọi lại. |
API disabled | Tài khoản của bạn đang bị tắt quyền gọi API. | Liên hệ hỗ trợ để bật lại. |
Email not verified | Email của bạn chưa được xác minh. | Xác minh email trên website rồi gọi lại. |
Too many requests | Quá 300 yêu cầu mỗi phút trên key của bạn, hoặc IP của bạn gửi quá nhiều key sai. | Chờ vài giây; hỏi trạng thái nhiều mã đơn trong một lần gọi. |
Maintenance | Hệ thống đang bảo trì (nếu chỉ add trả lỗi này: tạm ngừng nhận đơn mới). | Thử lại sau vài phút. |
Action not supported | Lệnh này không được hỗ trợ (VD refill). | Chỉ dùng các lệnh có trên trang này. |
Drip-feed not supported | Đã gửi runs / interval — chưa hỗ trợ chia nhỏ đơn (drip-feed). | Bỏ runs và interval. |
Incorrect order ID | Không có đơn này, hoặc đơn không phải của bạn. | Kiểm tra lại mã đơn. |
Incorrect ref_id | ref_id không phải chữ hoặc dài quá 64 ký tự. | Gửi chữ tối đa 64 ký tự. |
Incorrect since_id | since_id không phải số nguyên từ 0 trở lên. | Gửi id lớn nhất bạn đã nhận, hoặc bỏ tham số này. |
Internal error | Lỗi bất ngờ phía hệ thống. | Gọi lại đúng lệnh đó sau một lúc là an toàn; riêng add thì đợi lâu hơn thời gian xử lý tối đa 60 giây và hỏi status theo ref_id trước khi gửi lại. |
Method not allowed | Chỉ nhận GET và POST; câu trả lời này kèm mã HTTP 405. | Dùng POST. |
Request too large | Thân yêu cầu quá lớn; câu trả lời này kèm mã HTTP 413. | Gửi ít mã đơn hơn hoặc link ngắn hơn. |
Not found | Sai địa chỉ dưới /api/v2; câu trả lời này kèm mã HTTP 404. | Gọi đúng địa chỉ https://korea.seedingthucong.com/api/v2. |
Timed out, order not placed | Lệnh add không kịp xong trong hạn (tối đa 60 giây); không có đơn nào được tạo và không bị trừ tiền — lỗi phía chúng tôi, không phải do lệnh của bạn. | Không phải lỗi nghiệp vụ: gửi lại add ngay là an toàn — dùng lại ref_id cũ cũng được. |
Missing parameter: X | Thiếu tham số X. | Thêm X vào thân yêu cầu. |
Too many order IDs (max 100) | Quá 100 mã đơn trong một lần gọi. | Tách thành nhiều lần gọi, mỗi lần tối đa 100 mã. |
Incorrect service ID | Không có server này, hoặc bạn không dùng được server này. | Gọi services để lấy lại danh sách mã. |
Service not active | Server này đã ngừng bán. | Chọn server khác (xem lệnh updates). |
Service under maintenance | Server đang bảo trì. | Thử lại sau hoặc chọn server khác. |
Service temporarily unavailable | Server tạm thời không nhận đơn. | Thử lại sau vài phút. |
Incorrect quantity | quantity không phải số nguyên dương. | Gửi một số nguyên, VD 1000. |
Quantity less than minimal X | Số lượng thấp hơn mức tối thiểu. | Tăng số lượng lên ít nhất X. |
Quantity more than maximal X | Số lượng vượt mức tối đa. | Giảm số lượng hoặc tách thành nhiều đơn. |
Incorrect link | Link sai định dạng hoặc không thuộc nền tảng của server này. | Kiểm tra lại link và nền tảng. |
Not enough funds on balance | Số dư không đủ. | Nạp thêm rồi đặt lại. |
Order amount is below minimum | Tiền đơn thấp hơn mức tối thiểu. | Tăng số lượng. |
You have active order with this link. Please wait until order being completed. | Server này không cho hai đơn đang chạy cùng một link. | Chờ đơn trước chạy xong. |
Incorrect comments | Server “Custom Comments” không nhận được dòng nào dùng được trong comments / usernames (rỗng, chỉ có dòng trống, hoặc không phải chữ). | Gửi danh sách dạng chữ, mỗi dòng một mục. |
Too many comments | comments / usernames quá lớn để xử lý (hơn 900 KB sau khi mã hoá — chữ tiếng Việt và emoji tính gấp khoảng 3 lần). | Chia danh sách thành nhiều đơn. |
Line N is longer than X characters | Dòng N của comments / usernames dài hơn mức server cho phép (X ký tự). | Rút ngắn dòng đó rồi gửi lại. |
Order can't be canceled | Server không cho huỷ, hoặc đơn đã kết thúc. | Đừng gọi lại. |
Cancel already requested | Đã gửi yêu cầu huỷ trước đó. | Chờ và theo dõi bằng status. |