REST API

API docs for resellers

Integrate the store into your own system: look up products, check your balance, place orders and receive the data automatically over the REST API. Every request authenticates with the header X-API-Key.

Your API key

Authentication

Send your API key in a header with every request:

curl "https://sieuthirb.com/api/products" \
  -H "X-API-Key: YOUR_API_KEY"

# Đặt hàng
curl -X POST "https://sieuthirb.com/api/order" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_code":"SP-AB12CD","quantity":1}'

Authorization: Bearer <key> also works. Never send the key in the URL (?api_key=) — that is rejected, because URLs are commonly written to logs.

Rate limits & error codes

• Product listing: up to 60 requests per 15 minutes per IP.
• Failed calls (wrong key, out of stock, insufficient balance): up to 60 per 15 minutes per IP.
• Going over the limit returns 429 with retryAfter (seconds). Wait exactly that long before retrying — do not hammer the endpoint.

Code	Meaning
200	Success.
400	Invalid request data, out of stock, or insufficient balance.
401	Missing or invalid API key.
403	Account suspended, or IP blocked.
404	Product or order not found.
405	Wrong method (for example a GET to /api/order).
413	Request body exceeds 64KB.
429	Too many requests — see retryAfter.

Every response includes success (true/false) and message. Check success rather than relying on the HTTP status alone.

Endpoints

GET/api/products

Products currently on sale with prices and stock, grouped by category. Add ?flat=1 for a flat, ungrouped array.

Example response

{
  "success": true,
  "status": "success",
  "message": "Lấy dữ liệu thành công!",
  "count": 12,
  "categories": [
    {
      "id": 3,
      "parent_id": 0,
      "name": "Tài khoản Streaming",
      "slug": "tai-khoan-streaming",
      "products": [
        {
          "id": 41,
          "code": "SP-AB12CD",
          "name": "Netflix Premium 4K — 1 Tháng",
          "slug": "netflix-premium-4k-1-thang",
          "price": 79000,
          "discount": 15,
          "final_price": 67150,
          "quantity_discounts": [
            { "min_quantity": 10, "percent": 5 }
          ],
          "amount": 60,
          "min": 1,
          "max": 50
        }
      ]
    }
  ]
}

GET/api/product?code=SP-AB12CD

Details for one product, including the full description and warranty period. ?id= works too.

Example response

{
  "success": true,
  "status": "success",
  "message": "Lấy dữ liệu thành công!",
  "data": {
    "id": 41,
    "code": "SP-AB12CD",
    "name": "Netflix Premium 4K — 1 Tháng",
    "price": 79000,
    "discount": 15,
    "final_price": 67150,
    "amount": 60,
    "min": 1,
    "max": 50,
    "full_description": "Bảo hành trọn gói, hỗ trợ đổi mới...",
    "warranty_days": 30,
    "category": {
      "id": 3,
      "name": "Tài khoản Streaming",
      "slug": "tai-khoan-streaming"
    }
  }
}

GET/api/products-child

Two-level category tree: parent category → child category → products. Use it to rebuild the store's menu.

Example response

{
  "success": true,
  "status": "success",
  "message": "Lấy dữ liệu thành công!",
  "categories": [
    {
      "id": 1,
      "name": "Tài khoản",
      "slug": "tai-khoan",
      "child_categories": [
        {
          "id": 3,
          "name": "Tài khoản Streaming",
          "slug": "tai-khoan-streaming",
          "products": [ "... như /api/products ..." ]
        }
      ]
    }
  ]
}

GET/api/profile

API key owner account information: username, email, wallet balance.

Example response

{
  "success": true,
  "status": "success",
  "message": "Lấy dữ liệu thành công!",
  "data": {
    "username": "reseller01",
    "email": "[email protected]",
    "full_name": "Nguyễn Văn A",
    "balance": 1500000,
    "commission_balance": 42000,
    "total_spent": 8300000,
    "total_deposited": 9800000,
    "order_count": 137
  }
}

POST/api/order

Place an order and receive the account data immediately. The wallet is charged directly; product_id works in place of product_code.

Request body

{
  "product_code": "SP-AB12CD",
  "quantity": 1,
  "coupon": "SALE10"
}

Example response

{
  "success": true,
  "status": "success",
  "message": "Đặt hàng thành công!",
  "data": {
    "order_code": "DH-7K2M9X",
    "product": "Netflix Premium 4K — 1 Tháng",
    "quantity": 1,
    "unit_price": 67150,
    "discount": 6715,
    "total": 60435,
    "balance": 1439565,
    "accounts": ["[email protected]|matkhau123"]
  }
}

GET/api/order/{order_code}

Look up an existing order and the data it delivered. Only returns orders belonging to the API key holder.

Example response

{
  "success": true,
  "status": "success",
  "message": "Lấy đơn hàng thành công!",
  "data": {
    "order_code": "DH-7K2M9X",
    "status": "completed",
    "total": 60435,
    "discount": 6715,
    "coupon": "SALE10",
    "refunded": false,
    "created_at": "2026-08-22T09:14:07.000Z",
    "items": [
      {
        "product_code": "SP-AB12CD",
        "product": "Netflix Premium 4K — 1 Tháng",
        "quantity": 1,
        "unit_price": 67150,
        "subtotal": 67150,
        "accounts": ["[email protected]|matkhau123"]
      }
    ]
  }
}

Need help with the integration? Contact us.

Loading…

curl "https://sieuthirb.com/api/products" \ -H "X-API-Key: YOUR_API_KEY" # Đặt hàng curl -X POST "https://sieuthirb.com/api/order" \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"product_code":"SP-AB12CD","quantity":1}'

Code

Meaning

200

Success.

400

Invalid request data, out of stock, or insufficient balance.

401

Missing or invalid API key.

403

Account suspended, or IP blocked.

404

Product or order not found.

405

Wrong method (for example a GET to /api/order).

413

Request body exceeds 64KB.

429

Too many requests — see retryAfter.

Endpoints

GET/api/products

Products currently on sale with prices and stock, grouped by category. Add ?flat=1 for a flat, ungrouped array.

Example response

{
  "success": true,
  "status": "success",
  "message": "Lấy dữ liệu thành công!",
  "count": 12,
  "categories": [
    {
      "id": 3,
      "parent_id": 0,
      "name": "Tài khoản Streaming",
      "slug": "tai-khoan-streaming",
      "products": [
        {
          "id": 41,
          "code": "SP-AB12CD",
          "name": "Netflix Premium 4K — 1 Tháng",
          "slug": "netflix-premium-4k-1-thang",
          "price": 79000,
          "discount": 15,
          "final_price": 67150,
          "quantity_discounts": [
            { "min_quantity": 10, "percent": 5 }
          ],
          "amount": 60,
          "min": 1,
          "max": 50
        }
      ]
    }
  ]
}

GET/api/product?code=SP-AB12CD

Details for one product, including the full description and warranty period. ?id= works too.

Example response

{
  "success": true,
  "status": "success",
  "message": "Lấy dữ liệu thành công!",
  "data": {
    "id": 41,
    "code": "SP-AB12CD",
    "name": "Netflix Premium 4K — 1 Tháng",
    "price": 79000,
    "discount": 15,
    "final_price": 67150,
    "amount": 60,
    "min": 1,
    "max": 50,
    "full_description": "Bảo hành trọn gói, hỗ trợ đổi mới...",
    "warranty_days": 30,
    "category": {
      "id": 3,
      "name": "Tài khoản Streaming",
      "slug": "tai-khoan-streaming"
    }
  }
}

GET/api/products-child

Two-level category tree: parent category → child category → products. Use it to rebuild the store's menu.

Example response

{
  "success": true,
  "status": "success",
  "message": "Lấy dữ liệu thành công!",
  "categories": [
    {
      "id": 1,
      "name": "Tài khoản",
      "slug": "tai-khoan",
      "child_categories": [
        {
          "id": 3,
          "name": "Tài khoản Streaming",
          "slug": "tai-khoan-streaming",
          "products": [ "... như /api/products ..." ]
        }
      ]
    }
  ]
}

GET/api/profile

API key owner account information: username, email, wallet balance.

Example response

{
  "success": true,
  "status": "success",
  "message": "Lấy dữ liệu thành công!",
  "data": {
    "username": "reseller01",
    "email": "[email protected]",
    "full_name": "Nguyễn Văn A",
    "balance": 1500000,
    "commission_balance": 42000,
    "total_spent": 8300000,
    "total_deposited": 9800000,
    "order_count": 137
  }
}

POST/api/order

Place an order and receive the account data immediately. The wallet is charged directly; product_id works in place of product_code.

Request body

{
  "product_code": "SP-AB12CD",
  "quantity": 1,
  "coupon": "SALE10"
}

Example response

{
  "success": true,
  "status": "success",
  "message": "Đặt hàng thành công!",
  "data": {
    "order_code": "DH-7K2M9X",
    "product": "Netflix Premium 4K — 1 Tháng",
    "quantity": 1,
    "unit_price": 67150,
    "discount": 6715,
    "total": 60435,
    "balance": 1439565,
    "accounts": ["[email protected]|matkhau123"]
  }
}

GET/api/order/{order_code}

Look up an existing order and the data it delivered. Only returns orders belonging to the API key holder.

Example response

{
  "success": true,
  "status": "success",
  "message": "Lấy đơn hàng thành công!",
  "data": {
    "order_code": "DH-7K2M9X",
    "status": "completed",
    "total": 60435,
    "discount": 6715,
    "coupon": "SALE10",
    "refunded": false,
    "created_at": "2026-08-22T09:14:07.000Z",
    "items": [
      {
        "product_code": "SP-AB12CD",
        "product": "Netflix Premium 4K — 1 Tháng",
        "quantity": 1,
        "unit_price": 67150,
        "subtotal": 67150,
        "accounts": ["[email protected]|matkhau123"]
      }
    ]
  }
}