Confluence REST API — расширение тела страницы при извлечении страницы по заголовку

Я получаю доступ к странице Confluence по ее title, используя последнюю версию REST API. Чтобы получить более подробную информацию об определенных полях, я передаю параметр expand (см. Документы по Confluence):

https://xyz.atlassian.net/wiki/rest/api/content/?title=Architecture&spaceKey=XX&expand=body

or

https://xyz.atlassian.net/wiki/rest/api/content/?title=Architecture&spaceKey=XX&expand=body.view

Но результаты не содержат никакой информации о теле найденной страницы.

Обратите внимание, что это нормально работает с запросами, использующими только идентификатор страницы. Использование заголовка для получения страницы похоже на результаты поиска, поэтому функция расширения, похоже, не работает так же. Согласно документации, это должно работать как мой пример. Я что-то пропустил?


person david    schedule 18.12.2015    source источник
comment
Как насчет двух запросов: первый использует заголовок для поиска идентификатора, а второй — запрос по идентификатору с расширением тела?   -  person Adam Taylor    schedule 18.12.2015
comment
Спасибо, Адам, это текущее решение, но с точки зрения производительности оно неприемлемо.   -  person david    schedule 21.12.2015


Ответы (1)


Вам нужно указать, какой тип «тела» вы хотите в параметре расширения.

В вашем случае примерно так:

https://xyz.atlassian.net/wiki/rest/api/content/?title=Architecture&spaceKey=XX&expand=body.view

https://xyz.atlassian.net/wiki/rest/api/content/?title=Architecture&spaceKey=XX&expand=body.export_view

Возможные значения:

  • редактор
  • export_view
  • анонимный_экспорт_просмотр
  • Посмотреть
  • место хранения
person mtheriault    schedule 18.12.2015
comment
Спасибо за Ваш ответ! Действительно, я пробовал комбинацию различных параметров, таких как: &spaceKey=XX&type=page&expand=space,body.view,version,container,page.body.view,results.body.view,page.body,results.body - но результаты всегда остаются прежними - person david; 21.12.2015
comment
Ммм... очень странно, это работает на моих экземплярах (v5.7 и v5.8.5): .../rest/api/content?spaceKey=DOC&title=Making%20a%20template&expand=body.export_view - person mtheriault; 21.12.2015
comment
У вас есть собственный экземпляр или Confluence по запросу (размещенный в облаке)? В экземплярах PAAS у Atlassian есть несколько других настроек... - person david; 21.12.2015
comment
Да, я только что попробовал, и кажется, что параметр запроса title не работает. Я могу сделать это: /wiki/rest/api/content?spaceKey=DS1&expand=body.view, но не это: /wiki/rest/api/content?spaceKey=DS1&title=Demonstration%20Space&expand=export.view. Результаты не возвращаются, как вы. Похоже, это ошибка версии 6. - person mtheriault; 21.12.2015
comment
Вы можете попробовать поиск REST API и CQL, в моем случае это работает: /wiki/rest/api/content/search?cql=space=DS1%20and%20title=My%20First%20Page&expand=body. просмотреть - person mtheriault; 21.12.2015
comment
+1 за export_view. Это помогло мне скопировать страницу, содержащую макросы. У меня было требование копировать не макросы, а результат макроса. export_view помог добиться этого. Есть ли лучший способ или это правильный путь? - person Sandeep Kanabar; 14.01.2017