Phân trang & Rate limit

Phân trang và giới hạn tần suất HiTechPos: phân trang danh sách bằng page_number/page_size và hạn mức số yêu cầu gọi API.

Xem Markdown

Các endpoint trả về danh sách đều hỗ trợ phân trang bằng page_number và page_size, kèm khối meta.pagination cho biết tổng số bản ghi và còn trang tiếp theo hay không.

Tham số phân trang

Tham sốKiểuMặc địnhMô tả
page_numberinteger1Số thứ tự trang cần lấy
page_sizeinteger20Số bản ghi mỗi trang, tối đa 100

Khối meta.pagination

TrườngMô tả
totalTổng số bản ghi khớp bộ lọc
page_sizeSố bản ghi mỗi trang đang áp dụng
page_numberTrang hiện tại
total_pagesTổng số trang
has_moretrue nếu còn trang sau

Giới hạn tần suất (Rate Limits)

Nhóm thao tácGiới hạnHeader trả về
Đọc (GET)1800 requests / phút / cửa hàngX-RateLimit-Limit: 1800
Ghi (POST/PUT/DELETE)600 requests / phút / cửa hàngX-RateLimit-Limit: 600
Điều chỉnh tồn kho180 requests / phút / cửa hàngX-RateLimit-Limit: 180
Khi vượt hạn mức, API trả về 429 Too Many Requests kèm header Retry-After cho biết số giây cần đợi.

Duyệt toàn bộ dữ liệu bằng vòng lặp

Lặp qua tất cả trang sản phẩm
import os, requests

key = os.getenv("HITECHPOS_API_KEY")
shop = "shop_0a1b2c3d"
headers = {"Authorization": f"Bearer {key}"}
page = 1
all_products = []

while True:
    r = requests.get(
        f"https://pos.hitechcloud.vn/api/v1/shops/{shop}/products",
        headers=headers,
        params={"page_number": page, "page_size": 100},
    )
    body = r.json()
    all_products.extend(body["data"])
    if not body["meta"]["pagination"]["has_more"]:
        break
    page += 1

print(f"Da lay {len(all_products)} san pham")