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ả.

Xem Markdown

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ểuMặc địnhMô tả
pageinteger1Số thứ tự trang cần lấy
per_pageinteger20Số 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
per_pageSố bản ghi mỗi trang đang áp dụng
current_pageTrang hiện tại
last_pageTrang cuối cùng
has_moretrue 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ử.