如何通过Bitbucket REST API删除分支？遇405错误求助

首先给你明确几个核心点：

• 405 Method Not Allowed错误的含义：这个错误表示你发送的HTTP请求方法（这里是DELETE）不被目标API端点支持。简单说就是服务器能识别你访问的URL，但不允许用DELETE方式来操作它。你的请求完全没有被执行，不会对分支产生任何修改，相当于直接被服务器挡在了门外。
• 你网页UI能正常删除分支，说明权限没问题，问题大概率出在API请求的格式细节上。

可能的原因和对应的解决办法 #

• DELETE请求带了不必要的Body：
  很多REST API的DELETE接口不需要请求体，Bitbucket的分支删除API就是如此。你在Postman的Body里放了JSON数据，这反而可能让服务器认为你的请求格式不符合要求，从而返回405。
  解决办法：把Postman里Body标签的内容清空，直接发送空Body的DELETE请求。

• API URL路径不正确：
  虽然你创建分支成功了，但删除分支的API路径和创建的可能有细微差别，比如分支名称的格式要求。比如Bitbucket Cloud的删除分支正确端点是：

  DELETE https://api.bitbucket.org/2.0/repositories/{workspace}/{repo_slug}/refs/branches/{branch_full_path}
  

  这里要注意branch_full_path需要是分支的完整路径，比如feature/new-login而不是只写new-login。如果是Bitbucket Server/Data Center，路径会是类似/rest/api/1.0/projects/{projectKey}/repos/{repoSlug}/branches/{branchId}，你需要确认分支ID是否正确（可以通过GET分支列表的API获取）。

• 请求头设置不当：
  如果你设置了Content-Type: application/json但又没有Body，有些服务器会判定请求不合法。可以尝试去掉这个请求头，或者保持头但确保Body为空。

按照上面的步骤调整后，应该就能正常删除分支了。

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