Tài liệu API

Giới hạn tốc độ

Giới hạn giúp một ứng dụng không làm chậm các ứng dụng khác. Chúng khá rộng cho việc dùng bình thường; dù vậy hãy tính tới khả năng gặp 429.

Các giới hạn

GìGiới hạn
Gọi API600 mỗi phút cho mỗi ứng dụng trong mỗi tenant (cửa sổ cố định một phút). Stracker có thể đặt giá trị khác cho một ứng dụng.
Endpoint token30 mỗi phút cho mỗi client và địa chỉ IP. Hãy dùng lại token đến khi hết hạn thay vì xin một token cho mỗi lệnh gọi.
Sự kiện webhook thử10 mỗi phút cho mỗi subscription.
Subscription webhook10 mỗi ứng dụng trong một tenant, 20 mỗi tenant, mỗi cái 30 loại sự kiện.
Payload webhookTối đa 64 KiB.
Kích thước tranglimit có mức tối đa riêng cho từng danh sách; xem thao tác trong tham chiếu.

Header

Mọi câu trả lời của API mang trạng thái cửa sổ của bạn: RateLimit-Limit (số lệnh gọi được phép), RateLimit-Remaining (số lệnh gọi còn lại) và RateLimit-Reset (số giây đến khi cửa sổ được đặt lại).

HTTP
HTTP/1.1 200 OK
RateLimit-Limit: 600
RateLimit-Remaining: 597
RateLimit-Reset: 41

Khi gặp 429

HTTP
HTTP/1.1 429 Too Many Requests
RateLimit-Limit: 600
RateLimit-Remaining: 0
RateLimit-Reset: 23
Retry-After: 23
Content-Type: application/problem+json
  • Nội dung là 429 RATE_LIMITED. Hãy chờ ít nhất Retry-After giây trước khi gọi lại.
  • Gửi lại thao tác ghi với cùng Idempotency-Key (idempotency).
  • Giãn việc ra: giảm tần suất truy vấn, duyệt danh sách lớn theo trang thay vì tải song song, và dùng webhook thay cho việc truy vấn liên tục để biết thay đổi.
  • Nếu tích hợp của bạn cần nhiều hơn, hãy cho chúng tôi biết nó làm gì và vì sao; chúng tôi có thể nâng giới hạn cho một ứng dụng.