我如何创建一个新的页面来与Python融合

Question

我正在尝试使用Python的xmlrpclib创建一个融合的新页面。我已经知道如何更新现有页面的内容，但是如何创建一个全新的页面？

我用下面的脚本来更新内容：

import xmlrpclib 

CONFLUENCE_URL='https://wiki.*ownURL*/rpc/xmlrpc' 

def update_confluence(user, pwd, pageid, newcontent):  
    client = xmlrpclib.Server(CONFLUENCE_URL,verbose=0)  
    authToken=client.confluence2.login(user,pwd) 
    page = client.confluence2.getPage(authToken, pageid) 
    page['content'] = newcontent 
    cient.confluence2.storePage(authToken, page) 
    client.confluence2.logout(authToken) 

，并在更新内容时效果很好。但问题是，不知何故我需要在创建新页面时解析pageID，并且我不知道如何做到这一点。

有没有其他方法可以创建新页面？

Answer 1

我不知道Python，但可以用REST调用做到这一点：

echo '{"type":"page","ancestors":[{"type":"page","id":'$CONFLUENCE_PARENT_PAGE'}],"title":"'$PAGE_NAME'","space":{"key":"'$CONFLUENCE_SPACE'"},"body":{"storage":{"value":"'$CONTENT'","representation":"storage"}}}' > body.json 

curl --globoff --insecure --silent -u ${CONFLUENCE_USER}:${CONFLUENCE_PASSWORD} -X POST -H 'Content-Type: application/json' --data @body.json $CONFLUENCE_REST_API_URL 

汇合REST API的URL看起来是这样的： https://confluence.yourdomain.com/rest/api/content/

基本上回答你的问题是你需要在创建全新页面时将父页作为祖先发送。

Answer 2

您可以使用该合流REST API网页： https://docs.atlassian.com/atlassian-confluence/REST/latest-server/

这里是在Python3工作的例子。你需要知道父页面的ID。

import requests 
import json 
import base64 

# Set the confluence User and Password for authentication 
user = 'USER' 
password = 'PASSWORD' 

# Set the title and content of the page to create 
page_title = 'My New Page' 
page_html = '<p>This page was created with Python!</p>' 

# You need to know the parent page id and space key. 
# You can use the /content API to search for these values. 
# Parent Page example http://example.com/display/ABC/Cheese 
# Search example: http://example.com/rest/api/content?title=Cheese 
parent_page_id = 123456789 
space_key = 'ABC' 

# Request URL - API for creating a new page as a child of another page 
url = 'http://example.com/rest/api/content/' 

# Create the basic auth for use in the authentication header 
auth = base64.b64encode(b'{}:{}'.format(user, password)) 

# Request Headers 
headers = { 
    'Authorization': 'Basic {}'.format(auth), 
    'Content-Type': 'application/json', 
} 

# Request body 
data = { 
    'type': 'page', 
    'title': page_title, 
    'ancestors': [{'id':parent_page_id}], 
    'space': {'key':space_key}, 
    'body': { 
     'storage':{ 
      'value': page_html, 
      'representation':'storage', 
     } 
    } 
} 

# We're ready to call the api 
try: 

    r = requests.post(url=url, data=json.dumps(data), headers=headers) 

    # Consider any status other than 2xx an error 
    if not r.status_code // 100 == 2: 
     print("Error: Unexpected response {}".format(r)) 
    else: 
     print('Page Created!') 

except requests.exceptions.RequestException as e: 

    # A serious problem happened, like an SSLError or InvalidURL 
    print("Error: {}".format(e))