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.
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ểu | Mặc định | Mô tả |
|---|---|---|---|
page_number | integer | 1 | Số thứ tự trang cần lấy |
page_size | integer | 20 | Số bản ghi mỗi trang, tối đa 100 |
Khối meta.pagination
| Trường | Mô tả |
|---|---|
total | Tổng số bản ghi khớp bộ lọc |
page_size | Số bản ghi mỗi trang đang áp dụng |
page_number | Trang hiện tại |
total_pages | Tổng số trang |
has_more | true nếu còn trang sau |
Giới hạn tần suất (Rate Limits)
| Nhóm thao tác | Giới hạn | Header trả về |
|---|---|---|
| Đọc (GET) | 1800 requests / phút / cửa hàng | X-RateLimit-Limit: 1800 |
| Ghi (POST/PUT/DELETE) | 600 requests / phút / cửa hàng | X-RateLimit-Limit: 600 |
| Điều chỉnh tồn kho | 180 requests / phút / cửa hàng | X-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")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ểu | Mặc định | Mô tả |
|---|---|---|---|
page_number | integer | 1 | Số thứ tự trang cần lấy |
page_size | integer | 20 | Số bản ghi mỗi trang, tối đa 100 |
Khối meta.pagination
| Trường | Mô tả |
|---|---|
total | Tổng số bản ghi khớp bộ lọc |
page_size | Số bản ghi mỗi trang đang áp dụng |
page_number | Trang hiện tại |
total_pages | Tổng số trang |
has_more | true nếu còn trang sau |
Giới hạn tần suất (Rate Limits)
| Nhóm thao tác | Giới hạn | Header trả về |
|---|---|---|
| Đọc (GET) | 1800 requests / phút / cửa hàng | X-RateLimit-Limit: 1800 |
| Ghi (POST/PUT/DELETE) | 600 requests / phút / cửa hàng | X-RateLimit-Limit: 600 |
| Điều chỉnh tồn kho | 180 requests / phút / cửa hàng | X-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")