Tài liệu cho nhà phát triểnBắt đầu
Giới hạn tần suất và giới hạn khác
Tần suất yêu cầu, quy mô tác vụ, số tác vụ đồng thời và thời gian lưu trữ.
Dưới đây là giá trị mặc định. GET /v1/limits trả về giá trị áp dụng cho tổ chức của bạn.
| Giới hạn | Giá trị |
|---|---|
| Yêu cầu mỗi phút / giờ / ngày | 60 / 1.000 / 5.000 |
Số kiện mỗi tác vụ (tổng quantity) | 2.000 |
| Số xe mỗi tác vụ (kể cả xe được thêm) | 20 |
| Thời gian tính toán tối đa mỗi tác vụ | 90 s |
| Tác vụ được tính toán cùng lúc | 1 |
| Tác vụ đang chờ + đang chạy | 20 |
| Loại xe | truck, trailer, container, pallet |
| Nội dung yêu cầu | 10 MB |
?wait | 60 s |
| Thời gian lưu nội dung, kết quả, liên kết PDF | 14 ngày |
Giới hạn tần suất
Được tính theo phút, giờ và ngày, cho từng khóa và cho cả tổ chức. Giới hạn chặt nhất được áp dụng.
| Header | Ý nghĩa |
|---|---|
X-RateLimit-Limit | Giới hạn của khung thời gian chặt nhất |
X-RateLimit-Remaining | Số yêu cầu còn lại trong khung đó |
X-RateLimit-Reset | Thời điểm Unix khung được đặt lại |
Retry-After | Khi gặp 429: số giây cần chờ |
Vượt giới hạn: 429 rate_limited. Hơn 60 lần xác thực thất bại mỗi phút từ một IP cũng nhận về 429.
Tác vụ
Tác vụ vượt giới hạn đồng thời sẽ chờ ở trạng thái queued. Khi đã có 20 tác vụ đang chờ + đang chạy, POST /v1/pack trả về 429 too_many_jobs.
Lưu trữ
Nội dung yêu cầu và kết quả, cùng liên kết PDF, bị xóa sau 14 ngày (expires_at trên mỗi tác vụ). Trạng thái, số liệu và chi phí vẫn được giữ.