API Documentation

API v2.0 - RESTful

Tích hợp dịch vụ SMM vào hệ thống của bạn dễ dàng với API mạnh mẽ.

http://tangmatlive.vn/api/v2

HTTPS Required

Giới thiệu

API của chúng tôi tuân theo chuẩn RESTful, sử dụng phương thức POST cho tất cả các request. Response trả về định dạng JSON.

Lưu ý quan trọng:

• Tất cả request phải gửi qua HTTPS
• Rate limit: 100 requests/phút
• API key cần giữ bí mật, không chia sẻ cho bất kỳ ai

Xác thực (Authentication)

Mỗi request cần gửi kèm key - API key của bạn. Bạn có thể lấy API key trong phần Cài đặt API sau khi đăng nhập.

POST Ví dụ Request

{
    "key": "YOUR_API_KEY",
    "action": "services"
}

Danh sách dịch vụ

Lấy danh sách tất cả dịch vụ và giá của bạn.

Request

{
    "key": "YOUR_API_KEY",
    "action": "services"
}

Response

[
    {
        "service": 1,
        "name": "Facebook Likes",
        "rate": "0.50",
        "min": 100,
        "max": 10000,
        "category": "Facebook"
    }
]

Đặt đơn hàng

Tạo đơn hàng mới cho một dịch vụ.

Tham số	Mô tả	Bắt buộc
`key`	API key của bạn
`action`	add
`service`	ID dịch vụ
`link`	URL/Link bài viết cần tăng
`quantity`	Số lượng cần mua

Request

{
    "key": "YOUR_API_KEY",
    "action": "add",
    "service": 1,
    "link": "https://facebook.com/post/123",
    "quantity": 1000
}

Response

{
    "order": 12345
}

Kiểm tra đơn hàng

Kiểm tra trạng thái của một hoặc nhiều đơn hàng.

Request

{
    "key": "YOUR_API_KEY",
    "action": "status",
    "order": 12345
}

Response

{
    "charge": "0.50",
    "start_count": "1000",
    "status": "Completed",
    "remains": "0"
}

Trạng thái đơn hàng:

Pending Processing Completed Canceled Partial

Số dư tài khoản

Kiểm tra số dư tài khoản hiện tại.

Request

{
    "key": "YOUR_API_KEY",
    "action": "balance"
}

Response

{
    "balance": "150.25",
    "currency": "USD"
}

Yêu cầu Refill

Tạo yêu cầu refill cho đơn hàng đã hoàn thành. Chỉ áp dụng cho dịch vụ có hỗ trợ refill.

Request

{
    "key": "YOUR_API_KEY",
    "action": "refill",
    "order": 12345
}

Response

{
    "refill": 789
}

Lưu ý: Đơn hàng phải ở trạng thái Completed và dịch vụ phải hỗ trợ refill. Mỗi đơn chỉ có 1 refill active tại một thời điểm.

Hủy đơn hàng

Hủy đơn hàng đang chờ xử lý. Số tiền sẽ được hoàn trả tự động vào tài khoản.

Request

{
    "key": "YOUR_API_KEY",
    "action": "cancel",
    "order": 12345
}

Response

{
    "order": 12345,
    "cancel": true
}

Lưu ý: Chỉ hủy được đơn hàng ở trạng thái Pending. Đơn đã bắt đầu xử lý không thể hủy qua API.

Yêu cầu hoàn tiền

Gửi yêu cầu hoàn tiền cho đơn hàng đã hoàn thành, lỗi, hoặc partial. Yêu cầu sẽ được admin xem xét và xử lý.

Request

{
    "key": "YOUR_API_KEY",
    "action": "refund",
    "order": 12345
}

Response

{
    "order": 12345,
    "refund": "pending_review"
}

Lưu ý: Hoàn tiền cần admin duyệt. Đơn hàng sẽ chuyển sang trạng thái Investigation trong thời gian chờ.

Mã lỗi

Danh sách các mã lỗi có thể xảy ra.

Error	Mô tả	Cách xử lý
`invalid_api_key`	API key không hợp lệ	Kiểm tra lại API key
`insufficient_balance`	Không đủ số dư	Nạp thêm tiền vào tài khoản
`invalid_service`	Dịch vụ không tồn tại	Kiểm tra ID dịch vụ
`invalid_quantity`	Số lượng không hợp lệ	Kiểm tra min/max của dịch vụ
`invalid_link`	Link không hợp lệ	Kiểm tra định dạng link
`rate_limit`	Vượt quá giới hạn request	Đợi và thử lại sau

Sẵn sàng tích hợp?

Đăng ký tài khoản để nhận API key và bắt đầu sử dụng ngay

Đăng ký ngay