Phân trang & Lọc dữ liệu
Phân trang và bộ lọc trong HiTechCloud Pay API: dùng page, per_page và các tham số lọc để duyệt khối lượng lớn giao dịch và tài khoản hiệu quả.
Các endpoint trả về danh sách (bank-accounts, transactions, sub-accounts) đều hỗ trợ phân trang bằng tham số page và per_page, cùng khối meta.pagination để bạn 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 | integer | 1 | Số thứ tự trang cần lấy |
per_page | 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 |
per_page | Số bản ghi mỗi trang đang áp dụng |
current_page | Trang hiện tại |
last_page | Trang cuối cùng |
has_more | true nếu còn trang sau, false nếu đã hết |
Duyệt toàn bộ dữ liệu bằng vòng lặp
Lặp qua tất cả các trang giao dịch
import requests, os
token = os.getenv("HITECHCLOUD_PAY_API_TOKEN")
headers = {"Authorization": f"Bearer {token}"}
page = 1
all_tx = []
while True:
r = requests.get(
"https://userapi.hitechcloud.vn/v2/transactions",
headers=headers,
params={"page": page, "per_page": 100},
)
body = r.json()
all_tx.extend(body["data"])
if not body["meta"]["pagination"]["has_more"]:
break
page += 1
print(f"Đã lấy {len(all_tx)} giao dịch")Nên dùng
per_page=100 kết hợp bộ lọc from_date/to_date để giảm số lần gọi và tránh chạm giới hạn rate limit khi đồng bộ dữ liệu lịch sử.Các endpoint trả về danh sách (bank-accounts, transactions, sub-accounts) đều hỗ trợ phân trang bằng tham số page và per_page, cùng khối meta.pagination để bạn 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 | integer | 1 | Số thứ tự trang cần lấy |
per_page | 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 |
per_page | Số bản ghi mỗi trang đang áp dụng |
current_page | Trang hiện tại |
last_page | Trang cuối cùng |
has_more | true nếu còn trang sau, false nếu đã hết |
Duyệt toàn bộ dữ liệu bằng vòng lặp
Nên dùng
per_page=100 kết hợp bộ lọc from_date/to_date để giảm số lần gọi và tránh chạm giới hạn rate limit khi đồng bộ dữ liệu lịch sử.Lặp qua tất cả các trang giao dịch
import requests, os
token = os.getenv("HITECHCLOUD_PAY_API_TOKEN")
headers = {"Authorization": f"Bearer {token}"}
page = 1
all_tx = []
while True:
r = requests.get(
"https://userapi.hitechcloud.vn/v2/transactions",
headers=headers,
params={"page": page, "per_page": 100},
)
body = r.json()
all_tx.extend(body["data"])
if not body["meta"]["pagination"]["has_more"]:
break
page += 1
print(f"Đã lấy {len(all_tx)} giao dịch")