Wercker API调用未正确识别author查询参数问题求助

我之前折腾Wercker v3 API的时候也碰到过一模一样的坑！给你几个实际可行的排查方向和解法：

• 先确认author参数的正确取值
  Wercker的API里，author参数要求的是用户的用户名（不是显示名称），而且严格区分大小写。另外，有些场景下可能需要用用户的UUID而非用户名——你可以先调用GET /api/v3/users/me（如果是查自己）或者搜索用户的接口，拿到目标用户的准确标识符，再代入参数试试。

• 检查URL编码问题
  如果你的author值里包含空格、@这类特殊字符，一定要做URL编码。比如把author=Jane Doe改成author=Jane%20Doe，直接传未编码的特殊字符会导致API解析错误，大概率会匹配到错误的用户（甚至是默认的系统用户）。

• 明确API参数的匹配逻辑
  注意Wercker v3 API的author参数，匹配的是代码提交的作者，而不是触发CI运行的用户。如果有些运行是自动触发的（比如合并PR时），提交作者可能是仓库的默认用户，而非手动触发的人。你可以先调用不带author的接口，查看返回的记录里目标用户的运行记录对应的author字段值，再用这个值去过滤。

• 强制按时间排序排查
  默认情况下API返回最近20条，但添加author参数后，可能返回的是该用户的旧记录，而你误以为没有结果。可以加上排序参数：

  GET /api/v3/runs?author=<正确的用户名>&pipelineId=<pipelineID>&sort=createdAt&direction=desc
  

  强制按创建时间倒序，确保能看到该用户最新的运行记录。

举个实际操作的例子：

1. 调用GET /api/v3/runs?pipelineId=<pipelineID>，找到目标用户的一条运行记录，查看它的author对象里的username字段（比如"username": "thermatix"）
2. 用这个准确的用户名作为author参数发起请求，就能正确过滤出该用户的运行记录了

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