如何使用Bitbucket Server V1 API在仓库中搜索指定文本？

Bitbucket Server 7.21.5的V1 API提供了代码搜索接口，可以绕过UI的限制直接搜索仓库内的指定文本，具体操作如下：

核心接口 #

使用POST请求调用/rest/api/1.0/search/code端点，这是官方提供的专门用于代码内容搜索的API。

关键参数（JSON请求体） #

请求需以JSON格式传递参数，必填项和常用可选参数如下：

• query：必填，要搜索的目标文本，支持精确匹配（用双引号包裹，如"exact search phrase"）和简单关键词匹配
• repositoryId：必填，目标仓库的ID，可通过访问仓库页面查看URL中的数字，或调用/rest/api/1.0/projects/{项目键}/repos/{仓库slug}接口获取
• projectKey：可选，指定项目键，进一步缩小搜索范围（适用于多个仓库重名的场景）
• limit：可选，控制单次返回的结果数量，默认25，最大100
• start：可选，分页起始位置，用于翻页获取更多结果

请求示例（curl） #

用基本认证发起请求，替换对应参数即可：

curl -u 你的用户名:你的密码 -X POST -H "Content-Type: application/json" \
  https://你的Bitbucket服务器地址/rest/api/1.0/search/code \
  -d '{
    "query": "要查找的目标文本",
    "repositoryId": 123,
    "limit": 50
  }'

注意事项 #

• 权限要求：必须拥有目标仓库的读取权限，否则会返回403错误
• 搜索范围：仅搜索仓库内的代码文件，不涵盖wiki、拉取请求描述或评论内容
• 特殊字符处理：如果查询文本包含双引号等特殊字符，需在JSON中转义（如\"）
• 分页：若结果超过limit设置的数量，需通过调整start参数（如start=50）获取下一页内容

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