Clonetraucho API

1.0.0 OAS 3.1

/openapi.json ↗

API đại lý để lấy sản phẩm, kiểm tra số dư, tạo đơn và đọc lại dữ liệu đã mua.

Quản lý API key

Lấy API keyTạo và phân quyền key tại trang Profile.

Gửi qua headerDùng X-API-Key hoặc Authorization: Bearer.

Retry an toànĐơn mua bắt buộc có Idempotency-Key duy nhất.

Serverhttps://www.traubommo.com

Endpoint công khai, trả về các danh mục sản phẩm đang hoạt động.

Parameters

Không có tham số.

Ví dụ yêu cầu

curl

curl https://www.traubommo.com/api/v1/categories

Responses

HTTP	Mô tả
200	Danh sách danh mục

{
  "data": [
    {
      "id": 1,
      "name": "TẤT CẢ SẢN PHẨM",
      "slug": "all"
    }
  ]
}

{
  "$ref": "#/components/schemas/CategoryList"
}

Try it out

Yêu cầu chỉ được gửi khi bạn bấm nút bên dưới.

Chưa nhập API key

Response

Endpoint công khai. Gửi API key để nhận giá sau chiết khấu riêng theo từng sản phẩm; không gửi key sẽ nhận giá niêm yết.

Parameters

Tên	Vị trí	Yêu cầu	Mô tả
`X-API-Key`	header	Tùy chọn	Nhận giá riêng nếu có key.

Ví dụ yêu cầu

curl

curl https://www.traubommo.com/api/v1/products \
  -H "X-API-Key: YOUR_KEY"

Responses

HTTP	Mô tả
200	Danh sách sản phẩm

{
  "data": [
    {
      "id": 10,
      "name": "Tiktok Japan",
      "description": "Login bằng username và pass",
      "format_text": "username|password|2fa",
      "country_code": "jp",
      "base_price": 2999,
      "discount_percent": 10,
      "price": 2700,
      "stock": 50,
      "category": "CLONE TIKTOK"
    }
  ]
}

{
  "$ref": "#/components/schemas/ProductList"
}

Try it out

Yêu cầu chỉ được gửi khi bạn bấm nút bên dưới.

Chưa nhập API key

Response

Yêu cầu API key có quyền balance:read.

Parameters

Tên	Vị trí	Yêu cầu	Mô tả
`X-API-Key`	header	Bắt buộc	API key có quyền balance:read.

Ví dụ yêu cầu

curl

curl https://www.traubommo.com/api/v1/balance \
  -H "X-API-Key: YOUR_KEY"

Responses

HTTP	Mô tả
200	Thông tin số dư
401	API key không hợp lệ
403	API key thiếu quyền balance:read

{
  "data": {
    "username": "daily_agent",
    "balance": 100000,
    "pricing_mode": "per_product",
    "discounted_product_count": 2
  }
}

{
  "$ref": "#/components/schemas/Balance"
}

Try it out

Yêu cầu chỉ được gửi khi bạn bấm nút bên dưới.

Chưa nhập API key

Response

Tạo đơn mua thật và trừ tiền trong ví. Idempotency-Key là bắt buộc để retry an toàn mà không tạo đơn trùng.

⚠ Đây là endpoint mua thật.Chỉ gửi sau khi xác nhận sản phẩm, số lượng, giá hiện tại và Idempotency-Key.

Parameters

Tên	Vị trí	Yêu cầu	Mô tả
`X-API-Key`	header	Bắt buộc	API key có quyền orders:write.
`Idempotency-Key`	header	Bắt buộc	Mã duy nhất cho một yêu cầu mua.

Request body application/json

{
  "product_id": 10,
  "quantity": 1
}

Ví dụ yêu cầu

curl

curl -X POST https://www.traubommo.com/api/v1/orders \
  -H "X-API-Key: YOUR_KEY" \
  -H "Idempotency-Key: order-20260731-001" \
  -H "Content-Type: application/json" \
  -d '{"product_id":10,"quantity":1}'

Responses

HTTP	Mô tả
200	Đơn đã tồn tại hoặc hoàn tất
201	Tạo đơn thành công
401	API key không hợp lệ
402	Số dư không đủ
409	Hết hàng hoặc Idempotency-Key xung đột
502	Nguồn API từ chối đơn

{
  "data": {
    "order_id": 123,
    "status": "completed",
    "total": 2999,
    "delivery": "username|password|2fa"
  }
}

{
  "$ref": "#/components/schemas/Order"
}

Try it out

Yêu cầu chỉ được gửi khi bạn bấm nút bên dưới.

Chưa nhập API key

Response

Trả về tối đa 100 đơn còn trong thời hạn lưu dữ liệu.

Parameters

Tên	Vị trí	Yêu cầu	Mô tả
`X-API-Key`	header	Bắt buộc	API key có quyền orders:read.

Ví dụ yêu cầu

curl

curl https://www.traubommo.com/api/v1/orders \
  -H "X-API-Key: YOUR_KEY"

Responses

HTTP	Mô tả
200	Danh sách đơn hàng
401	API key không hợp lệ
403	API key thiếu quyền orders:read

{
  "data": [
    {
      "order_id": 123,
      "status": "completed",
      "quantity": 1,
      "total": 2999,
      "product_name": "Tiktok Japan"
    }
  ]
}

{
  "$ref": "#/components/schemas/OrderList"
}

Try it out

Yêu cầu chỉ được gửi khi bạn bấm nút bên dưới.

Chưa nhập API key

Response

Chỉ trả về đơn thuộc tài khoản sở hữu API key.

Parameters

Tên	Vị trí	Yêu cầu	Mô tả
`X-API-Key`	header	Bắt buộc	API key có quyền orders:read.
`id`	path	Bắt buộc	ID đơn hàng cần đọc.

Ví dụ yêu cầu

curl

curl https://www.traubommo.com/api/v1/orders/123 \
  -H "X-API-Key: YOUR_KEY"

Responses

HTTP	Mô tả
200	Chi tiết đơn hàng
401	API key không hợp lệ
403	API key thiếu quyền orders:read
404	Không tìm thấy đơn

{
  "data": {
    "order_id": 123,
    "status": "completed",
    "quantity": 1,
    "total": 2999,
    "delivery": "username|password|2fa"
  }
}

{
  "$ref": "#/components/schemas/Order"
}

Try it out

Yêu cầu chỉ được gửi khi bạn bấm nút bên dưới.

Chưa nhập API key

Response

SchemasCấu trúc dữ liệu dùng chung trong OpenAPI.10 schema

CategoryXem trong OpenAPI ↗ProductXem trong OpenAPI ↗BalanceDataXem trong OpenAPI ↗OrderDataXem trong OpenAPI ↗CategoryListXem trong OpenAPI ↗ProductListXem trong OpenAPI ↗BalanceXem trong OpenAPI ↗OrderXem trong OpenAPI ↗OrderListXem trong OpenAPI ↗ErrorXem trong OpenAPI ↗

Mã lỗi thường gặp

HTTP	error	Ý nghĩa
401	`invalid_api_key`	Thiếu key, key sai hoặc key đã bị tắt.
403	`insufficient_scope`	API key không có quyền gọi endpoint này.
402	`insufficient_balance`	Ví không đủ để mua.
404	`product_not_found`	Sản phẩm hoặc đơn hàng không tồn tại.
409	`out_of_stock`	Tồn kho live không đủ hoặc giá nguồn không an toàn.
429	`rate_limited`	Gửi quá nhiều yêu cầu trong thời gian ngắn.