Tài liệu API

Tích hợp

Public REST API cho reseller / bot. Auth bằng header X-API-Key (tạo key tại Trang cá nhân).

Tổng quan

Base URL: https://api.thapcammmo.vn
Mỗi tài khoản có 1 API key (xem / tạo tại Trang cá nhân)
Auth: header X-API-Key: fag_…
Mỗi dịch vụ có id số global duy nhất (serviceId)
Rate limit: 100 request / phút (theo API key)
Response envelope: { "data": ..., "message": "" }

Endpoints

Method	Path	Mô tả
`GET`	`/v1/balance`	Lấy số dư ví
`GET`	`/v1/services`	Danh sách dịch vụ — mỗi item có id số global (serviceId)
`POST`	`/v1/orders`	Tạo đơn bằng serviceId (không cần serviceType)
`GET`	`/v1/orders`	Danh sách đơn của bạn
`GET`	`/v1/orders/:orderCode`	Chi tiết đơn theo orderCode (vd AMXKQT260723102045)

Ví dụ curl

# Số dư
curl -H "X-API-Key: YOUR_KEY" https://api.thapcammmo.vn/v1/balance

# Danh sách dịch vụ (lấy serviceId từ field id)
curl -H "X-API-Key: YOUR_KEY" "https://api.thapcammmo.vn/v1/services?serviceType=add_member"

# Tạo đơn — chỉ cần serviceId + field phụ
curl -X POST -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"serviceId":"1","groupLinks":["https://zalo.me/g/xxxx"],"quantity":100}' \
  https://api.thapcammmo.vn/v1/orders

# Chi tiết đơn (orderCode, ví dụ AMXKQT260723102045)
curl -H "X-API-Key: YOUR_KEY" https://api.thapcammmo.vn/v1/orders/AMXKQT260723102045

Body tạo đơn theo loại dịch vụ

Lấy serviceId từ GET /v1/services (field id). Không truyền serviceType.

`add_member (VIP)`

{
  "serviceId": "1",
  "groupLinks": ["https://zalo.me/g/xxxx"],
  "quantity": 100
}

`sell_group / sell_software`

{
  "serviceId": "12",
  "quantity": 1
}

`sell_catalog`

{
  "serviceId": "25",
  "pricingOptionId": "<optional mongo id>"
}

`sell_proxy`

{
  "serviceId": "40",
  "quantity": 1
}

`sell_buff`

{
  "serviceId": "55",
  "buffLink": "https://...",
  "quantity": 1000,
  "buffComments": "optional\none per line"
}