代理 API · v1 及 SHOPCLONE7 兼容
对接你的代理网站, 自动购买账号
获取商品列表,用钱包余额下单,并直接在 JSON 响应中收到账号。新对接请使用 API v1,或使用兼容 SHOPCLONE7 的 API,让 SHOPCLONE6/7 网站只需更换域名和 API key。
- Base URL
- /api/v1
- 格式
- JSON · UTF-8
- 认证
- Bearer API key
curl -X POST "https://your-domain/api/v1/orders" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 7f3c9a2e-order-1001" \
-d '{"product_id": 3, "quantity": 2}'认证
请在 Authorization: Bearer <API key> 请求头(或 X-API-Key)中携带你的 API key。切勿把密钥放在 URL 中;一旦泄露,请立即生成新的密钥。
GET
/api/v1/me账号信息
账号信息、钱包余额和购买频率限制。
请求
GET
https://your-domain/api/v1/me参数
名称类型说明
Authorization必填代码示例
curl "https://your-domain/api/v1/me" \
-H "Authorization: Bearer YOUR_API_KEY"响应示例
{
"success": true,
"data": {
"username": "daily01",
"email": "daily01@example.com",
"balance": 1250000,
"currency": "VND",
"limits": { "buy_interval_seconds": 3, "max_wait_seconds": 25 }
}
}GET
/api/v1/categories分类列表
启用中的分类及商品数量(含子分类)。
请求
GET
https://your-domain/api/v1/categories参数
名称类型说明
Authorization必填lang选填代码示例
curl "https://your-domain/api/v1/categories" \
-H "Authorization: Bearer YOUR_API_KEY"响应示例
{
"success": true,
"data": [
{ "id": 1, "parent_id": null, "name": "Facebook", "icon": "https://…/facebook.svg", "product_count": 11 },
{ "id": 8, "parent_id": 1, "name": "Via Việt Nam", "icon": null, "product_count": 4 }
]
}GET
/api/v1/products商品列表
支持筛选和分页的商品列表;价格为你的专属价格。
请求
GET
https://your-domain/api/v1/products?category_id=1&in_stock=1&page=1&limit=50参数
名称类型说明
Authorization必填category_id选填search选填in_stock选填page选填limit选填lang选填代码示例
curl "https://your-domain/api/v1/products?category_id=1&in_stock=1&page=1&limit=50" \
-H "Authorization: Bearer YOUR_API_KEY"响应示例
{
"success": true,
"data": [
{
"id": 3,
"name": "Via VN cổ 2FA",
"category_id": 8,
"price": 45000,
"currency": "VND",
"stock": 120,
"in_stock": true,
"min_quantity": 1,
"max_quantity": 100,
"country": "vn",
"description": "…",
"image": "https://…/via.png"
}
],
"meta": { "page": 1, "limit": 50, "total": 19, "total_pages": 1 }
}GET
/api/v1/products/{id}获取商品
按 ID 获取单个商品。
请求
GET
https://your-domain/api/v1/products/3参数
名称类型说明
Authorization必填id必填lang选填代码示例
curl "https://your-domain/api/v1/products/3" \
-H "Authorization: Bearer YOUR_API_KEY"响应示例
{
"success": true,
"data": {
"id": 3,
"name": "Via VN cổ 2FA",
"category_id": 8,
"price": 45000,
"currency": "VND",
"stock": 120,
"in_stock": true,
"min_quantity": 1,
"max_quantity": 100,
"country": "vn",
"description": "…",
"image": "https://…/via.png"
}
}POST
/api/v1/orders创建订单(购买)
使用钱包余额购买,并在响应中收到账号。支持 Idempotency-Key,可安全重试而不会重复购买。
请求
POST
https://your-domain/api/v1/orders参数
名称类型说明
Authorization必填Idempotency-Key选填product_id必填quantity必填coupon选填wait选填代码示例
curl -X POST "https://your-domain/api/v1/orders" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 7f3c9a2e-order-1001" \
-d '{"product_id": 3, "quantity": 2}'响应示例
{
"success": true,
"message": "Tạo đơn hàng thành công!",
"data": {
"code": "TSM261105TAKE49XD",
"status": "completed",
"source": "api",
"total": 90000,
"discount": 0,
"currency": "VND",
"coupon": null,
"quantity": 2,
"items": [
{ "product_id": 3, "name": "Via VN cổ 2FA", "unit_price": 45000, "quantity": 2, "total": 90000 }
],
"created_at": "2026-10-28T09:15:02.000Z",
"delivered": 2,
"accounts": [
"1000040304952|GUTJXYIFPWLHCNDOMBRKVAQESZ",
"1000087676467|IVMRLABECWTQYUXHPOFNJDSZGK"
]
}
}GET
/api/v1/orders订单列表
订单历史(最新在前),不含账号。
请求
GET
https://your-domain/api/v1/orders?status=completed&page=1参数
名称类型说明
Authorization必填status选填source选填page选填limit选填代码示例
curl "https://your-domain/api/v1/orders?status=completed&page=1" \
-H "Authorization: Bearer YOUR_API_KEY"响应示例
{
"success": true,
"data": [
{
"code": "TSM261105TAKE49XD",
"status": "completed",
"source": "api",
"total": 90000,
"discount": 0,
"currency": "VND",
"coupon": null,
"quantity": 2,
"items": [
{ "product_id": 3, "name": "Via VN cổ 2FA", "unit_price": 45000, "quantity": 2, "total": 90000 }
],
"created_at": "2026-10-28T09:15:02.000Z"
}
],
"meta": { "page": 1, "limit": 50, "total": 1, "total_pages": 1 }
}GET
/api/v1/orders/{code}获取订单
订单详情及已发放的账号。
请求
GET
https://your-domain/api/v1/orders/TSM261105TAKE49XD参数
名称类型说明
Authorization必填code必填代码示例
curl "https://your-domain/api/v1/orders/TSM261105TAKE49XD" \
-H "Authorization: Bearer YOUR_API_KEY"响应示例
{
"success": true,
"data": {
"code": "TSM261105TAKE49XD",
"status": "completed",
"source": "api",
"total": 90000,
"discount": 0,
"currency": "VND",
"coupon": null,
"quantity": 2,
"items": [
{ "product_id": 3, "name": "Via VN cổ 2FA", "unit_price": 45000, "quantity": 2, "total": 90000 }
],
"created_at": "2026-10-28T09:15:02.000Z",
"delivered": 2,
"accounts": [
"1000040304952|GUTJXYIFPWLHCNDOMBRKVAQESZ",
"1000087676467|IVMRLABECWTQYUXHPOFNJDSZGK"
]
}
}错误码
出错时 success = false;error.code 是供你的程序使用的稳定错误码,error.message 为可读信息,另附 request_id 供客服排查。
{
"success": false,
"error": {
"code": "insufficient_balance",
"message": "Số dư không đủ, vui lòng nạp thêm",
"status": 402
},
"request_id": "4c043782-5dac-4e19-8ef8-60b7ff3c7c20"
}400invalid_request400invalid_quantity400out_of_stock401missing_api_key401invalid_api_key402insufficient_balance403ip_not_allowed404product_not_found404order_not_found409idempotency_conflict429rate_limited503api_disabled503order_refunded对接说明
- 每次购买都请携带 Idempotency-Key,这样在网络错误或超时时可以安全重试。
- 订单未完全发货时 status = processing——请调用 GET /v1/orders/{code} 获取剩余部分。
- 同一密钥两次购买之间至少需间隔 3 秒。
- 返回的价格为你的专属价格(已应用等级价和 Flash Sale),单位为 VND。
- 每个响应都带有 X-Request-Id 请求头;联系客服时请一并提供。
- 仅自动发货的商品可通过 API 购买。