从 BitBucket Rest API v2.0 获取文件

Question

我有一个脚本，它使用 bitbucket REST API (1.0) 从 GIT 获取文件，但它最近停止工作。我推测这可能是由于 v1 REST API 被贬值所致，但我不确定。

无论如何，我正在尝试使用新的 2.0 REST API 检索文件，但由于请求不断失败，我似乎无法获得正确的语法。

我从curl 开始，因为它最容易测试。这就是我正在尝试的：

curl -u myusername@mydomain.com "https://api.bitbucket.org/2.0/repositories/MyCompany/myrepo/downloads/Scripts/Environment Setup/test.txt"

Enter host password for user 'myusername@mydomain.com': redacted

{"type": "error", "error": {"message": "Resource not found", "detail": "There is no API hosted at this URL.\n\nFor information about our API's, please refer to the documentation at: https://developer.atlassian.com/bitbucket/api/2/reference/"}}

这是我正在使用的参考文档：https://developer.atlassian.com/bitbucket/api/2/reference/resource/repositories/%7Busername%7D/%7Brepo_slug%7D/downloads/%7Bfilename%7D

也许我使用了错误的功能？我不知道。

Answer 1

为了后代的缘故，您不想使用以下命令从 bitbucket 下载单个文件：

https://api.bitbucket.org/2.0/repositories/MyCompany/myrepo/downloads/path/to/your/file.txt

（“下载”是下载整个存储库文件，如 .zip 文件）

相反，你想做的是：

curl --user myuser@mydomain.com:password "https://api.bitbucket.org/2.0/repositories/MyCompany/myrepo/src/master/path/to/file.txt"

如果您尝试使用 Invoke-RestRequest（在 powershell 中），请注意有一些额外的步骤。使用旧的 1.0 API 你可以这样做：

$cred = Get-Credential

$uri = "https://api.bitbucket.org/1.0/repositories/MyCompany/$($filepath)"

# Get the files from bitbucket (GIT)
Invoke-RestMethod -Credential $cred -Uri $uri -Proxy $proxyUri -OutFile $destination 

新的 2.0 API 不再有效。Powershell 的 Invoke-RestMethod 在发送凭据之前等待 401 响应，而新的 2.0 bitbucket api 从未提供响应，因此凭据永远不会发送，从而导致 403 禁止。

要解决这个问题，您必须使用以下丑陋的黑客来强制 Invoke-RestMethod 立即在授权标头中发送凭据：

$cred = Get-Credential


$uri = "https://api.bitbucket.org/2.0/repositories/MyCompany/$($filepath)"
$username = ($cred.GetNetworkCredential()).username
$password = ($cred.GetNetworkCredential()).password
$base64AuthInfo = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(("{0}:{1}" -f $username,$password)))

# Get the files from bitbucket (GIT)
Invoke-RestMethod -Headers @{Authorization=("Basic {0}" -f $base64AuthInfo)} -Uri $uri -Proxy $proxyUri -OutFile $destination 

希望这可以帮助其他人在未来！

感谢@Jim Redmond 的帮助。