Giới hạn và phân trang

Giới hạn tần suất

Mỗi khoá API được gọi 120 yêu cầu mỗi 60 giây. Phản hồi có RateLimit-Limit, RateLimit-Remaining và RateLimit-Reset; khi chạm giới hạn, phản hồi là 429 RATE_LIMITED kèm Retry-After tính bằng giây. Lệnh gọi tool MCP tính chung vào khoá đó.

Phân trang

Danh sách có thể lớn dùng phân trang keyset:

• limit — kích thước trang, mặc định 50, tối đa 100.
• cursor — giá trị page.next_cursor của trang trước.

{ "data": [ … ], "page": { "limit": 50, "next_cursor": "eyJ…" }, "correlation_id": "…" }

Đi theo next_cursor tới khi là null. Không dòng nào lặp giữa các trang, kể cả khi đang có dữ liệu mới được thêm. paginate() của SDK và --all của CLI làm việc này giúp bạn.

Thao tác hàng loạt

profiles.trash và profiles.restore nhận tối đa 1.000 id, proxies.delete tối đa 500, flows.run tối đa 1.000 hồ sơ. Kết quả trả về theo từng mục, nên một mục bị từ chối không che các mục khác.

Giới hạn của workspace

Các giới hạn như số phiên đồng thời được đặt theo workspace. usage.get cho thấy mức dùng hiện tại so với giới hạn đã đặt; limit: null nghĩa là chưa đặt giới hạn.