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://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 và code; chỉ lỗi đường truyền giữ mã HTTP thật: 404, 405, 413 và mọi lỗi 4xx khác (code bad_request). 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- true = server có bảo hành: gửi refill cho đơn Completed / Partial của server này trong thời hạn bảo hành
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
average_time- Số phút trung vị từ lúc đặt tới lúc bắt đầu chạy, trong 24 giờ qua; null khi chưa đủ đơn
speed_per_day- Số đơn vị chạy được mỗi ngày (trung vị), trong 24 giờ qua; null khi chưa đủ đơn
promise_start_minutes · promise_per_day- Cam kết của server: bắt đầu trong ngần này phút / chạy khoảng ngần này đơn vị mỗi ngày; null = không cam kết
promise_per_day_max · promise_speed_unit- Tốc độ cam kết dạng khoảng: promise_per_day là cận dưới, promise_per_day_max là cận trên (đều theo ngày; null = không có khoảng). promise_speed_unit là đơn vị lúc đặt cam kết — hour hoặc day; cam kết theo giờ vẫn trả theo ngày ở đây (× 24)
refill_days · refill_unit- Bảo hành dạng số: refill_days là số ngày bảo hành (số nguyên, null = không bảo hành — refill ở trên là refill_days > 0); refill_unit là đơn vị lúc đặt — day, week hoặc month (một tháng tính 30 ngày)
status- Trạng thái tốc độ, cập nhật vài phút một lần: fast (đạt hoặc vượt cam kết), normal, slow, very_slow, maintenance (bảo trì), paused (tạm ngừng nhận đơn)
status_note- Ghi chú của đội ngũ về server này, theo ngôn ngữ tên server của bạn; null khi không có
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=refillYêu cầu bảo hành
Yêu cầu bảo hành (refill) cho một đơn Completed hoặc Partial của server có refill: true, trong thời hạn bảo hành tính từ lúc đơn chốt. Hệ thống ghi nhận yêu cầu, đội ngũ của chúng tôi xử lý — không trừ cũng không hoàn tiền; theo dõi bằng refill_status. Mỗi đơn chỉ có một yêu cầu đang mở tại một thời điểm.
| 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à refill | refill |
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 bằng dấu phẩy → một danh sách, mỗi đơn một mục | 100245,100246 |
Đang hiện sk_live_… — đăng nhập và tạo API key để có key của riêng bạn.
refill- Mã yêu cầu bảo hành — giữ lại để hỏi refill_status
refill.error- Đơn này chưa bảo hành được lúc này — xem bảng lỗi
action=refill_statusTrạng thái bảo hành
Trạng thái các yêu cầu bảo hành của bạn. Chỉ hỏi những yêu cầu chưa xong.
| 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à refill_status | refill_status |
refill | Chọn 1 | số nguyên | Một mã refill → một đối tượng | 731 |
refills | Chọn 1 | chuỗi | Tối đa 100 mã refill, cách nhau bằng dấu phẩy → một danh sách, mỗi yêu cầu một mục | 731,732 |
Đang hiện sk_live_… — đăng nhập và tạo API key để có key của riêng bạn.
status- Một trong bốn giá trị dưới đây
Pending- Đã nhận, chưa xử lý
In progress- Đội ngũ đang xử lý
Completed- Đã bảo hành — kết thúc
Rejected- Không bảo hành — kết thúc; ghi chú thường nói lý do
note- Ghi chú của đội ngũ về yêu cầu này, giữ nguyên ngôn ngữ đã viết; không có thì không trả trường này
status.error- Không có yêu cầu này, hoặc không phải của bạn
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 đó.
In progress | Đã nhận và đang chạy — remains là phần còn lại. | 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ý
code — mã máy ngắn, không bao giờ đổi — script nên kiểm trường này. error — câu tiếng Anh theo chuẩn SMM API, giữ nguyên từng chữ để script đang so chuỗi vẫn chạy đúng.
code | error | Ý nghĩa | Nên làm gì |
|---|---|---|---|
invalid_key | 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 | 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 | 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 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. |
rate_limited | 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 | Maintenance | Toàn hệ thống đang bảo trì; mọi lệnh đều trả lỗi này. | Thử lại sau vài phút. |
action_not_supported | Action not supported | Lệnh này không có (VD lệnh drip-feed hay gói đăng ký). | Chỉ dùng các lệnh có trên trang này. |
drip_feed_not_supported | Drip-feed not supported | Đã gửi runs / interval — chưa hỗ trợ chia nhỏ đơn (drip-feed). | Bỏ runs và interval. |
order_not_found | 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 | 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 | 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 | 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 | 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 | 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 | 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://seedingthucong.com/api/v2. |
timed_out_not_placed | 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. |
refill_not_available | Refill is not available for this service | Server của đơn này không có bảo hành (services trả refill: false). | Đừng gửi lại — chỉ server có refill: true mới nhận yêu cầu bảo hành. |
order_not_completed | Order is not completed | Đơn còn đang chạy hoặc đã huỷ — chỉ đơn Completed hoặc Partial mới được bảo hành. | Chờ đơn thành Completed hoặc Partial; đơn đã huỷ không bảo hành được. |
refill_expired | Refill period has expired | Đã quá thời hạn bảo hành của server, tính từ lúc đơn chốt. | Đừng gọi lại. |
refill_in_progress | A refill request is already in progress for this order | Đơn này đã có một yêu cầu bảo hành chưa xong. | Theo dõi bằng refill_status; gửi yêu cầu mới khi yêu cầu đó thành Completed hoặc Rejected. |
refill_not_found | Incorrect refill ID | Không có yêu cầu bảo hành này, hoặc không phải của bạn. | Dùng mã refill mà lệnh refill đã trả. |
cannot_cancel | 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 | Cancel already requested | Đã gửi yêu cầu huỷ trước đó. | Chờ và theo dõi bằng status. |
missing_parameter | Missing parameter: X | Thiếu tham số X. | Thêm X vào thân yêu cầu. |
too_many_ids | 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ã. |
too_many_ids | Too many refill IDs (max 100) | Quá 100 mã refill 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ã. |
bad_request | Internal error | Yêu cầu bị từ chối ở tầng HTTP (ví dụ HTTP 400); câu trả lời giữ nguyên mã HTTP đó. | Đối chiếu phương thức, header và thân yêu cầu với trang này; đừng gửi lại y nguyên. |
orders_paused | Maintenance | Đang tạm ngừng nhận đơn mới; chỉ add trả lỗi này — status, cancel, refill và balance vẫn chạy bình thường. | Vẫn theo dõi đơn bằng status như thường; gửi add lại sau. |
incorrect_service | 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 | Service not active | Server này đã ngừng bán. | Chọn server khác (xem lệnh updates). |
service_maintenance | Service under maintenance | Server đang bảo trì. | Thử lại sau hoặc chọn server khác. |
service_unavailable | Service temporarily unavailable | Server tạm thời không nhận đơn. | Thử lại sau vài phút. |
incorrect_quantity | Incorrect quantity | quantity không phải số nguyên dương. | Gửi một số nguyên, VD 1000. |
quantity_below_min | 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_above_max | 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 | 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 | Not enough funds on balance | Số dư không đủ. | Nạp thêm rồi đặt lại. |
below_min_charge | Order amount is below minimum | Tiền đơn thấp hơn mức tối thiểu. | Tăng số lượng. |
duplicate_link | 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_content | 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. |
incorrect_content | Incorrect usernames | 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. |
content_too_large | 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. |
content_too_large | Too many usernames | 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. |
content_line_too_long | 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. |