Questions on bitbucket app

Hi all,

I am trying to get started to develop a bitbucket app and the least I can say is that the documentation is quite confusing. I have read the following documentation

There are several questions that seem very basic and do not have a simple answer on this documentation.

  1. What is the difference of implementation effort between a cloud and a data-center app? Is there example of difference here? Any example of a data-center and cloud app for bitbucket?
  2. When I create an App, I cannot even add Bitbucket as APIs and Features. Why?

Now, talking specifically about the cloud app page

  1. What is an example of payload for each webhook?
  2. What are the list of all potential webhooks? I want to receive a hook when there is a push. How do I know how to specify this?
  3. In ther oauthConsumer module, what is {{consumerKey}}?
  4. In the app descriptor, what is a webItems element? a repoPages element? a webPanels elements? There is no link on the documentation about what it is and how the elements are even used by the app.
  5. During the installation, the installation handshake sends a security context. I supposed it contains a symmetric key for encrypting the JWT but this is not even specified. What is the security context? How to use it? Any example? There is nothing specific (e.g. how the payload is sent, how it looks like, etc).

Finally, this is unclear if Bitbucket app can be put on the Marketplace (see first two questions). It would be great to have clear, unambiguous answers to these questions.

Thanks.

Interestingly, I tried to document my post with links and the only thing I got is the following picture. Let me know if you want me to add more information.

For the record, for question (7) I found the documentation on https://developer.atlassian.com/cloud/jira/platform/app-descriptor/ - are the arguments used the same for the bitbucket platform?

For the oauthConsumer module (see https://developer.atlassian.com/cloud/bitbucket/app-descriptor/), I still do not find information about it.

I still do not see a clear answer for all the other questions, any help is welcome and apreciated.

For the first 2 questions:

  1. What is the difference of implementation effort between a cloud and a data-center app? Is there example of difference here? Any example of a data-center and cloud app for bitbucket?

DataCenter apps are essentially server apps (you have some more cluster APIs available and you have to provide proof about scaling etc for DC apps but otherwise they are Server apps). Now the big difference between server and cloud apps - server apps are single tenant and require you to build using the atlassian sdk (maven, java, JavaScript etc). Cloud apps are multiple tenants and pretty much written in whatever you want (as long as you follow the integration framework).

  1. When I create an App, I cannot even add Bitbucket as APIs and Features. Why?
    Can you expand on this?

Now for the marketplace bit - Bitbucket cloud doesn’t have paid via atlassian marketplace support.

@danielwester thank you so much for your answer!