API SMM Reseller là gì? Hướng dẫn kết nối API SubGiare

API SMM Reseller là giao diện giúp một website, ứng dụng hoặc quy trình nội bộ trao đổi dữ liệu với hệ thống SMM bằng yêu cầu có cấu trúc. Thay vì đăng nhập và thao tác thủ công cho từng đơn, reseller có thể lấy danh sách dịch vụ, gửi đơn hợp lệ, kiểm tra trạng thái và đọc số dư từ phần mềm của mình. API phù hợp với nhu cầu tự động hóa có kiểm soát; nó không tự tạo ra chiến lược kinh doanh, không thay thế việc kiểm tra dữ liệu đầu vào và không bảo đảm kết quả trên nền tảng mạng xã hội.

SubGiare cung cấp API v2 tại một endpoint duy nhất. Bài viết này dựa trên tài liệu và hành vi hiện hành của hệ thống, sử dụng khóa giả YOUR_API_KEY trong mọi ví dụ. Không sao chép khóa thật vào mã nguồn công khai, ảnh chụp, kho Git hoặc nội dung hỗ trợ.

API SMM là gì và dành cho ai?

API là viết tắt của Application Programming Interface, tức giao diện lập trình ứng dụng. Với mô hình reseller, API thường là lớp kết nối giữa giao diện của bạn và hệ thống xử lý đơn. Nó hữu ích khi bạn cần đồng bộ danh mục đang hoạt động, tính giá hiển thị, tạo đơn từ một quy trình đã xác thực hoặc cập nhật trạng thái cho khách hàng.

API phù hợp với reseller có khả năng phát triển hoặc vận hành phần mềm, hiểu cách xử lý HTTP, lưu bí mật và chống gửi trùng. Nếu chỉ cần đặt vài đơn thủ công, trang Tạo đơn hàng thường đơn giản hơn. Trước khi tích hợp, hãy đọc đầy đủ tài liệu API SubGiare và thử từng action bằng dữ liệu không gây tạo đơn.

Endpoint và cách xác thực hiện hành

API hiện nhận yêu cầu POST tại:

https://subgiare.top/api/v2

Mỗi yêu cầu gửi API key trong trường key và tên thao tác trong trường action. Người dùng có thể tạo, sao chép hoặc thu hồi key tại trang Hồ sơ sau khi đăng nhập. Khóa đại diện cho quyền truy cập API của tài khoản, vì vậy chỉ nên được lưu ở phía máy chủ hoặc trình quản lý bí mật phù hợp.

curl -X POST 'https://subgiare.top/api/v2' \
  -d 'key=YOUR_API_KEY' \
  -d 'action=balance'

Không đặt key trong URL truy vấn, JavaScript chạy công khai trên trình duyệt hoặc tệp có thể tải xuống. Khi nghi ngờ khóa đã lộ, hãy thu hồi và tạo khóa mới, sau đó cập nhật ứng dụng sử dụng khóa đó.

Bốn action được hỗ trợ

1. Lấy danh sách dịch vụ với services

action=services trả về các dịch vụ đang hoạt động và được hiển thị cho khách hàng. Mỗi mục có thể gồm ID dịch vụ, tên, loại, chuyên mục, rate, Min/Max và cờ refill/cancel. Rate được trả bằng USD trên 1.000. Ứng dụng reseller nên làm mới danh sách theo chu kỳ hợp lý thay vì giả định một ID hoặc mức giá sẽ tồn tại mãi.

curl -X POST 'https://subgiare.top/api/v2' \
  -d 'key=YOUR_API_KEY' \
  -d 'action=services'

Khi một dịch vụ không còn xuất hiện, đừng tiếp tục gửi đơn bằng dữ liệu lưu cũ. Hãy đánh dấu mục đó là tạm không khả dụng trên giao diện của bạn và đồng bộ lại thông tin.

2. Tạo đơn với add

Để tạo đơn cơ bản, gửi action=add, ID dịch vụ, URL và số lượng. URL phải đúng loại mục tiêu mà dịch vụ yêu cầu; số lượng phải nằm trong Min/Max. Các dịch vụ bình luận tùy chỉnh có thể cần trường comments thay cho cách nhập số lượng thông thường.

curl -X POST 'https://subgiare.top/api/v2' \
  -d 'key=YOUR_API_KEY' \
  -d 'action=add' \
  -d 'service=1234' \
  -d 'link=https://example.com/public-post' \
  -d 'quantity=100' \
  -d 'request_id=client-order-20260816-001'

request_id là tham số tùy chọn dài 8–64 ký tự an toàn, dùng để retry mà không vô tình tạo thêm một đơn giống hệt khi client chưa nhận được phản hồi trước. Ứng dụng nên tạo một giá trị duy nhất cho mỗi đơn phía mình và tái sử dụng đúng giá trị đó khi thử lại cùng yêu cầu. Phản hồi thành công trả về mã đơn và trường replayed cho biết kết quả có phải bản phát lại hay không.

Action này có tác động tài chính và tạo đơn thật. Trong quá trình phát triển, không gửi add chỉ để kiểm tra kết nối. Bắt đầu với balance hoặc services, sau đó chỉ tạo đơn khi bạn có URL hợp lệ, ngân sách và quyền sử dụng rõ ràng.

3. Kiểm tra trạng thái với status

action=status nhận mã đơn thuộc tài khoản API. Phản hồi có thể bao gồm trạng thái, charge bằng USD, start count và remains. Client nên coi trạng thái từ API là nguồn cập nhật cho đơn đã tạo, đồng thời tránh gọi liên tục với tần suất không cần thiết.

curl -X POST 'https://subgiare.top/api/v2' \
  -d 'key=YOUR_API_KEY' \
  -d 'action=status' \
  -d 'order=12345'

Các trạng thái có thể phản ánh đơn đang chờ, đang xử lý, đang chạy, hoàn tất, một phần, hủy, hoàn tiền hoặc thất bại. Giao diện reseller nên trình bày trạng thái trung thực thay vì tự đổi một đơn chưa hoàn tất thành thành công.

4. Đọc số dư với balance

action=balance trả số dư tài khoản theo USD. Đây là action phù hợp để kiểm tra xác thực và khả năng kết nối mà không tạo đơn.

curl -X POST 'https://subgiare.top/api/v2' \
  -d 'key=YOUR_API_KEY' \
  -d 'action=balance'

Giới hạn request và xử lý lỗi

Giới hạn hiện hành được tài liệu công bố là 60 request/phút cho mỗi API key. Khi nhận HTTP 429, hãy đọc Retry-After, chờ rồi thử lại với backoff. Không tạo vòng lặp retry tức thời. Các mã HTTP 400, 401, 402, 404, 409, 422, 429 và 500 được sử dụng theo ngữ cảnh; phản hồi lỗi có dạng JSON với trường error.

• 400: action hoặc tham số cơ bản không hợp lệ.
• 401: API key không hợp lệ.
• 402: số dư không đủ cho yêu cầu.
• 404: dịch vụ hoặc đơn không tồn tại/không thuộc tài khoản.
• 409: xung đột, chẳng hạn yêu cầu trùng đang xử lý.
• 422: URL, số lượng hoặc loại dịch vụ không đáp ứng điều kiện.
• 429: vượt giới hạn tần suất.
• 500: lỗi máy chủ; ghi log an toàn và retry có kiểm soát.

Client nên đặt timeout, ghi lại mã HTTP, action, thời điểm và mã tham chiếu nội bộ. Không ghi API key hoặc dữ liệu nhạy cảm vào log. Nếu một request tạo đơn bị timeout, dùng lại cùng request_id thay vì tạo giá trị mới.

Quy trình tích hợp an toàn

1. Tạo API key và lưu trong biến môi trường hoặc kho bí mật phía máy chủ.
2. Gọi balance để xác minh kết nối.
3. Lấy services và chỉ hiển thị dữ liệu đang trả về.
4. Kiểm tra service, URL, Min/Max và số dư trước khi gọi add.
5. Gắn request_id duy nhất cho mỗi đơn phía client.
6. Lưu mã đơn trả về rồi kiểm tra bằng status với tần suất hợp lý.
7. Xử lý mọi lỗi theo mã HTTP, không suy đoán thành công khi chưa có phản hồi hợp lệ.

Kết luận

API SMM Reseller giúp giảm thao tác thủ công khi được tích hợp đúng cách. Giá trị thực tế nằm ở việc quản lý khóa an toàn, dùng danh mục hiện hành, chống gửi trùng và phản ánh trạng thái trung thực. Hãy bắt đầu từ tài liệu API chính thức của SubGiare, dùng FAQ khi cần giải thích quy trình, và chỉ gọi action tạo đơn khi dữ liệu đã được kiểm tra đầy đủ.