Update on Addressing issues with Marketplace reporting and APIs: General Availability begins this week

Timing

It is hard to understand when exactly and what will change. In the beginning, there is

Timing: The transition to the new data pipeline will occur as part of a phased rollout starting 13 October 2022 .

But later

This phased rollout will begin on with a small group of partners. We will share more details around the timeline for the rollout and start dates for each phase by 17th of October.

Invalid links

Two “Differences” links are to hello.atlassian.net which is not accessible to partners.

Differences in APIs

Please use exact API endpoints and field names when describing them. “Partners should anticipate that some data may change” doesn’t really help.

There is not such ‘updated date’ field in licenses and transactions API. There is a “lastUpdated” field. The same comment about “Ledger fields ($ impact fields ex - purchase price, vendor amount)”.

“the flag for Is sandbox is set as True” – according to the Marketplace REST API documentation there is a field “installedOnSandbox”. And in JSON the value is “true” and not “True”. According to the documentation “this field is in closed beta” – is it still so? Can / should we use it or no?

All these negligent mistakes doesn’t help partners to have confidence in the initial statement “The API signatures and fields remain the same in the reports”.

It would be much better to add all these comments in the REST API documentation as this page will disappear from the list of the latest CDAC posts.

Linking cloud instance hosts with licenses

I wanted to clarify about the licenses API field contactDetails.company. Currently it returns the host name of the cloud site (i.e. xxx from xxx.atlassian.net) and we use it to link the cloud sites to the corresponding Marketplace license. During the previous data pipeline migration this field was broken and started to return the actual company names and not host names. I wanted to clarify if after this data pipeline migration it will still return cloud host names.

6 Likes