1.2. 映射规则

映射规则在 API 产品和 API 后端级别上工作。映射规则定义了您要报告的指标或方法，具体取决于您的 API 请求。以下是映射规则示例：

这个规则表示，任何以 / 开头的 GET 请求都将按 1 增加指标 命中。此规则将与您的 API 的任何请求匹配。但最有可能会修改这个规则，因为它比较通用，而且在添加更多规则时通常会加倍计数。

Echo API 的以下规则显示更具体的示例：

映射规则的匹配通过前缀来执行，并可任意复杂（标记遵循 OpenAPI 和 ActiveDocs 规格）：

映射规则必须以正斜杠(/)开头。
您可以在字面字符串的路径上执行匹配项（例如： /hello）。
映射规则可以包含查询字符串或正文上的参数（例如： /{word}?value={value}）。APIcast 获取参数的方式如下：
- GET 方法：来自查询字符串。
- POST、DELETE 或 PUT 方法：来自正文。
映射规则可以包含命名通配符（例如： /{word}）。此规则将匹配占位符 {word} 中的任何内容，使请求（如 /morning ）与规则匹配。通配符可以在斜杠或斜杠与点之间出现。参数也可以包含通配符。
默认情况下，根据您指定的排序，从第一个到最后一个到最后一个映射规则评估所有映射规则。如果您添加规则 /v1 ，它将与路径以 /v1 开头的请求匹配（例如： /v1/word 或 /v1/sentence）。
您可以在模式的末尾添加一个美元符号($)来指定完全匹配项。例如，/v1/word$ 将仅匹配 /v1/word requests，并且不匹配 /v1/word/hello 请求。要完全匹配，还必须确保禁用了与所有(/)匹配的默认映射规则。
多个映射规则可以匹配请求路径，但如果都不匹配，则会使用 HTTP 404 状态代码丢弃该请求。