1.2. 3scale API の使用状況を把握するために APIcast がマッピングルールをどのように適用するか

API に対するリクエストに基づいて、マッピングルールにより API の使用状況を把握するメトリクスまたはメソッドを定義、指定します。マッピングルールの例を以下に示します。

View larger image

このルールは、/ で始まるすべての GET リクエストがメトリクス hits のカウントを 1 つ増やすことを意味します。このルールは API に対するすべてのリクエストにマッチします。これは有効なマッピングルールですが、一般的すぎるので、より具体的なルールが追加された時に、2 倍にカウントされることになります。

より具体的なルールの例として、Echo API マッピングルールを以下に示します。

View larger image

マッピングルールは、API プロダクトレベルおよび API バックエンドレベルで機能します。

ここで、同じ Echo API バックエンドを使用する Tools For Devs というプロダクトを追加することを考えてみます。

(get) /path/to/example/search
(get) /path/to/example/{id}

(get) /path/to/example/search
(get) /path/to/example/{id}

(get)/path/to/example/search の呼び出しを行う場合、ルールが一致すると、APIcast は残りのマッピングルールを処理してそのメトリクスのカウントを増やすのを停止します。