受信 REST API 要求が同じリソースの複数のレート制限ルールに一致する場合、レート制限の優先順位は次のように適用されます。

• 単一ユーザー用に設定されたルールは、すべてのユーザーのルールとロールを持つユーザーのルールを上書きします。
• ユーザーに設定されたルールと、すべてのユーザーのロール上書きルールがあります。

この例では、REST API リソース GET /now/v2/table/incident に 4 つのレート制限ルールがあります。

これらのレート制限ルールは、次の順序で適用されます。

1. ユーザーによるインシデントの制限は 、1 時間あたり最大 200 件の要求を送信できる ITIL ユーザーに適用されます。
2. インポートアドミニ ストレーターは、import_admin ロールを持つすべてのユーザーに適用されます。import_adminロールを持つ各ユーザーは、1 時間あたり最大 500 件の要求を送信できます。
3. itil によるインシデントの制限 は、itil ロールを持つすべてのユーザーに適用されます。itil ロールを持つ各ユーザーは、1 時間あたり最大 100 件の要求を送信できます。
4. インシデントの制限は すべてのユーザーに適用されます。各ユーザーは、1 時間あたり最大 100 件の要求を送信できます。

REST API エクスプローラーまたは Postman API プラットフォーム などの HTTP クライアントを使用して、受信 REST API 要求を生成できます。要求がレート制限ルールに一致する場合、いくつかの HTTP 応答ヘッダーがレート制限に関する情報を提供します。

• X-RateLimit-Limit は 、1 時間あたりに許可される要求の数を表示します。
• 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"
}