Danh sách sản phẩm (kèm tồn theo kho) — API Nhanh.vn

nhanh.v3.0.product.list

Request

Địa chỉ

Xác thực & gian hàng

Tham số request

Phân trang

Ví dụ request

curl -s -X POST "https://partner.quantri360.com/v1/nhanh/v3.0/product/list" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"filters":{"gpid":1,"status":[1]},"paginator":{"size":100,"sort":{"id":"desc"}}}'

import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.post(
    "https://partner.quantri360.com/v1/nhanh/v3.0/product/list",
    params={},
    json={
        "filters": {
            "gpid": 1,
            "status": [
                1
            ]
        },
        "paginator": {
            "size": 100,
            "sort": {
                "id": "desc"
            }
        }
    },
    headers={"Authorization": f"Bearer {KEY}"},
    timeout=60,
)
print(r.status_code)
print(r.json())

const KEY = 'q360_live_...'; // khóa API của brand
const url = new URL('https://partner.quantri360.com/v1/nhanh/v3.0/product/list');
for (const [k, v] of Object.entries({})) url.searchParams.set(k, typeof v === 'object' ? JSON.stringify(v) : String(v));
const r = await fetch(url, {
  method: 'POST',
  headers: { Authorization: `Bearer ${KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({"filters":{"gpid":1,"status":[1]},"paginator":{"size":100,"sort":{"id":"desc"}}}),
});
console.log(r.status, await r.json());

<?php
$key = 'q360_live_...'; // khóa API của brand
$url = 'https://partner.quantri360.com/v1/nhanh/v3.0/product/list' . '?' . http_build_query([]);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $key, 'Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"filters":{"gpid":1,"status":[1]},"paginator":{"size":100,"sort":{"id":"desc"}}}');
$res = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, "\n", $res;

Response

Tham số phản hồi (nguyên của Nhanh.vn)

Mẫu phản hồi

{
  "code": 1,
  "paginator": {
    "next": {
      "id": 40772035
    }
  },
  "data": [
    {
      "id": 40772431,
      "parentId": 40772423,
      "code": "WQDBF2012-Màu 2-XL",
      "barcode": "19371224",
      "name": "Quần da dáng suông/WQDBF2012/Màu 2 - Đen/XL/HERA14",
      "status": 1,
      "priceVatMode": 2,
      "importPriceVatMode": 0,
      "categoryId": 588000,
      "prices": {
        "retail": 889000,
        "retailVat": 0,
        "import": 0,
        "importVat": 0,
        "old": 0,
        "wholesale": 0,
        "avgCost": 0
      },
      "images": {
        "others": []
      },
      "warranty": [],
      "brandId": 66907,
      "type": 1,
      "shipping": {
        "width": 0,
        "height": 0,
        "length": 0,
        "weight": 0
      },
      "units": {
        "name": "Chiếc",
        "list": []
      },
      "combos": [],
      "inventory": {
        "remain": 4,
        "shipping": 0,
        "damaged": 0,
        "holding": 0,
        "transfering": 1,
        "available": 4,
        "warranty": {
          "remain": 0,
          "holding": 0
        },
        "depots": [
          {
            "id": 104483,
            "remain": 1,
            "shipping": 0,
            "damaged": 0,
            "holding": 0,
            "transfering": 0,
            "available": 1,
            "warranty": {
              "remain": 0,
              "holding": 0
            }
          },
          {
            "id": 104489,
            "remain": 0,
            "shipping": 0,
            "damaged": 0,
            "holding": 0,
            "transfering": 1,
            "available": 0,
            "warranty": {
              "remain": 0,
              "holding": 0
            }
          }
        ]
      },
      "attributes": [
        {
          "id": 1701118,
          "name": "Kích thước",
          "value": "XL",
          "code": "XL",
          "order": 0,
          "orderValue": 0
        },
        {
          "id": 1702238,
          "name": "Màu sắc",
          "value": "Đen",
          "code": "Đen",
          "order": 0,
          "orderValue": 0
        }
      ],
      "updatedAt": 1793083462,
      "createdAt": 1792750320,
      "tagIds": []
    }
  ]
}

Bắt đầu dùng

1. Đăng ký tài khoản Partner
2. Mở loại dữ liệu thuộc nhóm Sản phẩm ở trang nền tảng
3. Tạo API key (tick kênh Nhanh.vn)
4. Gọi theo ví dụ ở trên