Azure DevOps Git API查询分支存在性始终返回200状态码的疑问

这种设计是符合REST API通用设计惯例的，并非不合理，原因如下：

• 该接口的核心语义是查询符合过滤条件的引用列表，而非专门用于“校验单个分支是否存在”。当没有匹配结果时，返回空列表的200响应，属于“请求成功执行但无匹配数据”的正常业务场景，而非请求处理失败。
• HTTP状态码的本质是标识请求本身是否被服务器成功处理，而非业务逻辑层面的“是否找到目标数据”。只要服务器正常接收、解析并执行了查询请求，就会返回200；只有当请求格式错误、权限不足、仓库ID无效这类请求处理失败的情况，才会返回4xx/5xx类错误状态码。

实际处理建议 #

判断分支是否存在，需要检查响应体中的value数组：

• 若value数组为空，说明目标分支不存在
• 若value数组包含元素，则分支存在

示例判断逻辑（伪代码）：

response = requests.get("https://dev.azure.com/{organisation}/{project}/_apis/git/repositories/BaseSW-Lib-Tools/refs?filter=heads/BLAH")
data = response.json()
if len(data["value"]) == 0:
    print("分支不存在")
else:
    print("分支存在")

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