Is there documentation on REST API differences Bitbucket Server Vs Bitbucket Cloud

[BjornW]

I'm working on supporting Bitbucket Server (aka Stash) with https://github.com/afragen/github-updater so that users of this plugin may use a selfhosted Bitbucket Server (aka Stash) offering WordPress plugin / theme updates.

My questions are:

1. Where can I find an overview of REST API differences between Bitbucket Server & Bitbucket Cloud?
2. Are there plans to migrate to one REST API for both products, if so which API would be prevalent?
3. Out of curiosity why are the REST API's so different from each other?

Thanks in advance for your support!

[BjornW · Accepted solution]

Hi @Felix Haehnel, 

Thanks for your quick reply!

Your answer affirms my hypothesis on Bitbucket Server & Bitbucket Cloud being completely different products. A bit annoying, having to support different API's. Not just for me as an external developer just using Atlassian's products, but also for you Atlassian developers supporting it. Anyways, would be nice if this would be mentioned a bit more clearly somewhere on the sales page of Bitbucket Server.

ps: Improving the REST API docs would be great!

Thanks,

BjornW

[evzijst]

We're working to improve the documentation. You can go here for a sneak preview of what's coming: https://api-docs.bitbucket.io/bitbucket

[Felix]

Hi @Bjorn W,

there's no comprehensive listing of differences between the Bitbucket Cloud and Server REST APIs that I'm aware of. 

Your best bet would be to look for the endpoints you require in the Bitbucket Server REST API Reference. Note that there's separate References for all the bundled plugins too, which may help you. (We're working on consolidating and improving the REST docs!) 

For comparison, you can use the Bitbucket Cloud REST API documentation.

As for your other two questions: Bitbucket Server (formerly known as Stash) and Bitbucket Cloud really only share a brand name. While the two products share a lot of functionality and features, they were developed individually and thus have quite different looking REST APIs. We know this can be frustrating for developers wanting to support both Bitbucket Cloud and Server, and we do try to align any newly added endpoints where possible. 

Hope this helps, 

Felix

[afragen]

Is the above information still accurate given the new Bitbucket Cloud API 2.0?

I am the developer of the GitHub Updater plugin and I would like to continue to maintain compatibility.

[Johannes Kilian]

https://answers.atlassian.com/questions/33145966