Rate limit

Mỗi máy có hạn mức riêng — app lỗi vòng lặp không làm chậm người dùng thật của trại.

Ai gọiHạn mứcTính theo
Token app (OAuth)600 / phútapp × trại
API key nfk_600 / phútkhoá
POST /api/v1/iam/oauth/token10 / phútIP

Header

HeaderÝ nghĩa
X-RateLimit-LimitHạn mức mỗi phút (600).
X-RateLimit-RemainingCòn lại trong bucket.
X-RateLimit-ResetSố giây tới khi đầy lại.
Retry-AfterChỉ có khi 429: đợi bấy nhiêu giây rồi gọi lại.
429
HTTP/1.1 429 Too Many Requests
Retry-After: 1
X-RateLimit-Limit: 600
X-RateLimit-Remaining: 0

{ "title": "rate-limit-exceeded", "status": 429 }
Dashboard của app có thanh % phút hiện tại, đỉnh 24 giờ và số lượt 429 trong 7 ngày. App ≥ 200 lượt/giờ mà > 50% lỗi 4xx sẽ bị tạm dừng tự động (Reactivate ở trang Publish).