비율 제한은 특정 시간 창 내에서 엔드포인트에 요청할 수 있는 요청 수를 제어합니다. 이러한 제한은 서비스 안정성을 보장하고 Roblox 리소스를 남용으로부터 보호하는 데 도움이 됩니다.
발견
비율 제한을 결정하는 두 가지 방법이 있습니다: 참조 문서와 응답 헤더입니다.
문서 페이지
공식 비율 제한은 각 엔드포인트의 문서 페이지의 제한 섹션에서 확인할 수 있습니다. 요청을 보내기 전에 적용되는 비율 제한을 이해하기 위해 이러한 섹션을 확인하십시오.
응답 헤더
많은 API 응답에는 현재 비율 제한 상태에 대한 정보를 제공하는 헤더가 포함되어 있습니다.
| 헤더 | 설명 |
|---|---|
| x-ratelimit-limit | 비율 제한 윈도우 내에서 허용되는 총 요청 수. 이 값에는 여러 시간 창에 대한 여러 제한 값이 포함될 수 있습니다. |
| x-ratelimit-remaining | 현재 인증으로 아직 할 수 있는 요청의 수입니다. 이것이 0에 도달하면 HTTP 429 응답을 받게 됩니다. |
| x-ratelimit-reset | 비율 제한 할당량이 전체 제한으로 재설정될 때까지 남은 초 수입니다. |
다음은 API 응답에서의 비율 제한 헤더 예시입니다:
이 예시에서:
- 총 제한에서 998개의 요청이 남아 있습니다.
- 할당량은 20초 후에 재설정됩니다.
동작
비율 제한 동작은 인증 방법 및 요청 출처에 따라 다르며, Roblox 게임 내에서 요청을 하는지 여부에 따라서도 달라집니다.
API 키
API 키에 대한 비율 제한은 소유자(사용자 또는 그룹 중 하나)의 모든 API 키에 걸쳐 적용됩니다. 이러한 제한은 요청의 출처에 관계없이 일관되게 적용됩니다—HttpService, 웹 애플리케이션 또는 기타 출처에서 요청하든 상관없이 적용됩니다.
HttpService로 게임 내에서
HttpService를 사용하여 게임 내에서 엔드포인트를 호출할 때, 요청은 Roblox 게임 서버당 분당 500 HTTP 요청의 고정 한도에 기여합니다. 자세한 내용은 게임 내 HTTP 요청을 참조하십시오.
OAuth 2.0
OAuth 2.0 비율 제한은 액세스 토큰당 적용됩니다. 각 액세스 토큰은 사용자와 애플리케이션의 고유한 조합을 나타내므로, 귀하의 앱을 사용하는 각 사용자는 독립적인 비율 제한 할당량을 받습니다.
비율 제한 처리
문서화된 제한, 남용 방지 또는 고부하 시나리오로 인해 HTTP 429(요청이 너무 많음) 응답을 예상하고 처리하도록 코드를 작성하십시오. 비율 제한이 걸리면 retry-after 응답 헤더를 확인하여 재시도 시기를 알려주는 지침으로 사용하십시오. retry-after 응답 헤더가 없으면 지수 백오프 재시도 전략을 구현하십시오.