Hello everyone,
First of all, hello, if I made a mistake in some way creating an incompetent thread, I apologise.
Currently, in the project I am working on, we want to start the process of confluence api migration from version 1 to version 2. While checking the endpoints from the second version, I came across several problems regarding what the API returns, I would like to list a few points here and ask you to refer to this topic whether it will be possible to update.
1. GET - Spaces.
Currently, the application we are developing displays information about the space and the icon, what’s more, for certain places we need metadata and permissions.
Relative endpoint from REST API v2 which was tested: https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-space/#api-spaces-get
Example Object response via REST API v1:
{
id: 1,
key: 'XX',
name: 'XX,
icon: [Object],
description: [Object],
type: 'global',
metadata: [Object],
permissions: [Array],
status: 'current',
_expandable: [Object],
_links: [Object]
},
Example Object response via REST API v2:
{
name: 'XX',
key: 'XX',
id: 1,
type: 'global',
homepageId: 2,
status: 'current',
icon: null,
description: [Object]
},
How You can see permissions, metadata is not received by API. Icon is always null. I’m pretty sure that permissions and metadata is not received by API because we took it from REST API v1 because of expansion, but how we can access to those data in 2 version or is there plan to include?
2. GET - Page.
Currently, the application we are developing displays HTML which is coming from Confluence into our application.
Relative endpoint from REST API v2 which was tested: https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-page/#api-pages-id-get
What is missing based on observations (Endpoint which we are using in REST API v1: get-content):
- Author picture is missing
- Author name is missing
- History object is missing
- Version object is not fully completed - API is receiving authorID, but what about author name, picture etc.
- Body format view like we know from REST API v1 is not defined. We can see only storage and Atlassian docs format but it’s not a case for us. Is there any plan to introduce old format from V1? It’s possible to ask API v2 for 2 formats in one requests ?
3. Summary
I hope my questions are clear and I would like to ask for an answer.
