PagerDuty List Services接口如何通过query参数按服务名查询

返回结果不符合预期的核心原因有两个：

1. List Services 接口的query参数并非服务名称专属过滤字段，它是跨字段的全文模糊检索参数，匹配范围覆盖服务标签、描述、名称等多个字段，不会仅返回名称完全匹配的条目
2. 该接口默认分页大小为25，未显式传分页参数时只会返回第一页的25条数据，不会返回所有匹配结果

可行的高效实现方案 #

目前PagerDuty没有提供直接传入服务名称返回单个服务详情的原生接口，不需要拉取全量服务列表，用分页遍历+页内匹配的方式即可高效完成查询：

• 接口单页最大支持的limit值为100，不要设置超过100的limit，传值超过100时接口会自动截断为100，反而会导致逻辑异常
• 配合offset参数逐页拉取数据，请求时带上query参数传入目标服务名做预过滤，缩小每一页的返回范围
• 每拿到一页响应后，先在当前页的services数组中匹配name字段等于目标服务名的条目，匹配到直接终止遍历返回结果；如果响应中more字段为true，则将offset值加100请求下一页，直到more为false为止

第一页的请求示例如下：

curl --request GET \
  --url 'https://api.pagerduty.com/services?query=my-service-name&limit=100&offset=0' \
  --header 'Accept: application/vnd.pagerduty+json;version=2' \
  --header 'Authorization: Token token=y_NbAkKc66ryYTWUXYEu' \
  --header 'Content-Type: application/json'

这种方式因为加了query参数做预过滤，返回的结果都是和查询关键词相关的条目，大部分场景下目标服务在前1-2页就能匹配到，远比重置超大limit拉全量的效率高。

补充：如果是长期固定查询的服务，可以在服务配置页记录对应的服务ID，后续直接用单服务查询接口GET /services/{id}获取详情，是最稳定高效的方式。

内容的提问来源于stack exchange，提问作者manu muraleedharan