인바운드 REST API 요청이 동일한 자원에 대한 여러 속도 제한 규칙과 일치하는 경우 다음과 같이 속도 제한 우선순위가 적용됩니다.

• 단일 사용자에 대해 설정된 규칙은 모든 사용자에 대한 규칙과 역할이 있는 사용자에 대한 규칙을 재정의합니다.
• 모든 사용자에 대한 규칙을 무효화하는 역할이 있는 사용자에 대해 설정된 규칙입니다.

이 예시에는 REST API 자원 GET /now/v2/table/incident에 대한 네 가지 속도 제한 규칙이 있습니다.

이러한 속도 제한 규칙은 다음 순서로 적용됩니다.

1. 사용자별 인시던트 제한은 시간당 최대 200개의 요청을 제출할 수 있는 ITIL 사용자에게 적용됩니다.
2. 임포트 관리자에 따라 인시던트 제한 은 import_admin 역할이 있는 모든 사용자에게 적용됩니다. import_admin 역할을 가진 각 사용자는 시간당 최대 500개의 요청을 제출할 수 있습니다.
3. itil로 인시던트 제한 은 itil 역할을 가진 모든 사용자에게 적용됩니다. itil 역할을 가진 각 사용자는 시간당 최대 100개의 요청을 제출할 수 있습니다.
4. 인시던트 제한은 모든 사용자에게 적용됩니다. 각 사용자는 시간당 최대 100개의 요청을 제출할 수 있습니다.

REST API 탐색기 또는 HTTP 클라이언트(예Postman API 플랫폼: )를 사용하여 인바운드 REST API 요청을 생성할 수 있습니다. 요청이 요율 제한 규칙과 일치하면 여러 HTTP 응답 헤더가 요율 제한에 대한 정보를 제공합니다.

• X-RateLimit-Limit는 시간당 허용되는 요청 수를 표시합니다.
• X-RateLimit-Reset 은 다음에 UNIX 예약된 요율 제한 창의 재설정에 대한 타임스탬프를 표시합니다.
• X-RateLimit-Rule 은 적용 중인 요율 제한 규칙 [sys_rate_limit_rules]의 sys_id 표시합니다.

요율 제한을 초과하여 요청이 거부되면 시스템은 요율 제한에 대한 응답 헤더 외에 Retry-After 응답 헤더를 반환합니다. Retry-After 응답 헤더는 요율 제한을 초과하지 않도록 요청을 재시도할 수 있는 시간(초)을 표시합니다. 다음 오류 응답이 반환됩니다.

{
    "error": {
        "message": "Rate limit exceeded",
        "detail": "Rate limit of 100 requests per hour for Table API exceeded"
    },
    "status": "failure"
}