Comment créer une nouvelle page dans la Confluence utilisant leur API REST?

J'ai besoin de travail exemple de création d'une nouvelle page wiki dans la confluence à l'aide de l'api rest. Je préfère la nouvelle page sera créée sous espace spécifique et spécifique de la page. J'ai lu leur documentation de l'api et la regarda quelques exemples qu'ils ont eu et continuent à venir à court.

Voici un exemple qu'ils ont sur leur site

curl -u admin:admin -X POST -H 'Content-Type: application/json' -d'{"type":"page","title":"new page","space":{"key":"TST"},"body":{"storage":{"value":"<p>This is a new page</p>","representation":"storage"}}}' http://localhost:8080/confluence/rest/api/content/| python -mjson.tool

J'ai essayé ci-dessus avec mon espace de nom, nouveau titre et a changé l'url de mysite/repos/api/contenu
et retourné le contenu a été fondamentalement html de la page en disant que la page n'existe pas ou si la page existe, mais que vous n'avez pas la permission. J'ai confirmé que j'ai accès à confluence et peut créer de nouveaux wiki à l'aide de mes pouvoirs.

Ce qui est également pas clair, c'est dans l'exemple ci-dessus, comment est-il l'appel de l'api spécifique qui crée la page? Il ne fait pas de sens.

question semblable a été posée sur leur forum, mais pas de réponse raisonnable
https://answers.atlassian.com/questions/149561/simple-confluence-rest-api-usage-what-am-i-missing

(Je suppose que mon objectif final est d'être capable de créer une nouvelle page wiki sur confluence automatiquement) je suis d'accord pour renoncer à la confluence API REST d'autre solution si nécessaire.

InformationsquelleAutor DoodleKana | 2014-05-07
  1. 28

    De mes soupçons, c'est que vous n'êtes pas à l'aide d'une nouvelle version assez de Confluence. Le RESTE de l'API pour la création d'une nouvelle page a été introduit dans la Confluence 5.5 (qui est sorti de 8 jours). La documentation de l'API est versionné, et vous devriez toujours utiliser la version correspondant à votre Confluent de la libération. Le 5.5 API docs inclure la création d'une page de l'API vous avez besoin, mais les anciennes versions ne le font pas. Vous pouvez changer la version dans l'URL ci-dessus pour obtenir la version de l'API correspondant à votre Confluent de la libération.

    Confluence 5.4 et avant aussi utilisé une autre racine, préfixe pour l'API REST (repos/prototype/1/contenu) qui est une raison possible pour obtenir une page introuvable erreur.

    L'exemple sur la Atlassian site est également source de confusion car il comprend un extra "/confluence" dans l'URL, vous n'aurez besoin que si Confluence ont été mis en place avec un chemin de contexte. Cela pourrait également entraîner une page ne trouve pas d'erreur si vous utilisez la Confluence 5.5+ (bien que votre post suggère que vous avez déjà corrigé pour cette).

    En outre, vous devez dire à la Confluence que vous utilisez la méthode d'authentification de base par l'ajout d'un spécial os_authType paramètre de requête.

    L'exemple suivant fonctionne pour moi sur Confluence 5.5 (ne pas oublier de changer le port et la touche espace selon le cas).

    Pour la sécurité, j'ai également ajouté le type de contenu approprié à la Accept en-tête, bien que cela ne semble pas être nécessaire en pratique.

    curl -v -u admin:admin -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -d'{"type":"page","title":"new page","space":{"key":"ATTACH"},"body":{"storage":{"value":"<p>This is a new page</p>","representation":"storage"}}}' "http://localhost:8090/rest/api/content/?os_authType=basic"

    Pour répondre à votre dernière question, l'API spécifique qui crée la page est déterminée par l'URL elle-même et la méthode de la requête. Par exemple, l'exécution d'un GET sur "/repos/api/contenu" va chercher une page existante (compte tenu de la requête appropriée de paramètres), tout en effectuant un POST crée une nouvelle page.

    MODIFIÉES AFIN D'AJOUTER:

    Voir aussi mon commentaire ci-dessous pour savoir comment créer une page comme un enfant à une autre page, plutôt que de simplement au niveau supérieur d'un espace.

    • Merci pour une réponse rapide. Votre réponse efface beaucoup de questions que j'avais. Oui j'étais en utilisant l'ancienne version de la Confluence. J'ai aussi fait de ne pas activer l'API à distance de réglage sur la Confluence. Après l'activation de l'option, et à l'aide de 5.5 rend votre proposition de solution de travail. Maintenant je suis peut-être trop demander, mais, Avec cette nouvelle api rest puis-je utiliser le fichier au lieu de passer en html brut dans la commande. Aussi pouvez-vous préciser pages parent de l'id? La documentation ne l'avait pas. Peut-être parce qu'il n'est que de 8 jours 🙂
    • L'activation de la API à Distance est de bon conseil aussi. C'est totalement sans-papiers (YMMV avec les futures versions), mais vous pouvez spécifier la page parent à travers les "ancêtres" de la propriété en 5.5. Cela fonctionne pour moi de créer un enfant de page #1048582: curl -v -u admin:admin -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -d'{"type":"page","ancestors":[{"type":"page","id":1048582}],"title":"third new child page","space":{"key":"ATTACH"},"body":{"storage":{"value":"<p>This is a new page</p>","representation":"storage"}}}' "http://localhost:8090/rest/api/content/?os_authType=basic"
    • J'ai essayé ci-dessus et il fonctionne. Maintenant, je peux créer une nouvelle page, sous n'importe quelle autre page. J'ai aussi modifié curl réglage de peu, de sorte qu'il peut lire le nouveau contenu de la page à partir d'un fichier en utilisant l'option "-d @nom de fichier.json". Cette fonction peut être utile lorsque votre nouvelle page peut contenir beaucoup de contenu.
    • Je n'ai pas réussi à l'intestin, la fonctionnalité de mise à jour pour fonctionner correctement. Lors de la mise à jour d'un existant imbriquée de la page, il va aller de l'orphelin (à l'aide d'exemple curl fournis par le Confluent de la documentation de l'API) ou il deviendra un enfant de l'espace de la page d'accueil. Connecté un problème avec Atlassian CR-487
    • Est-il possible d'utiliser cette API pour créer des pages sur un Atlassian hébergé Confluence exemple?
    InformationsquelleAutor Scott Dudley
  2. 0

    Pas d'api REST, mais un travail autour de j'ai mis en place.
    Essayez ceci:

    Pour déplacer une page comme page enfant

    curl -X GET \
'<your-confluence-URL>/pages/movepage.action?pageId=<page-to-be-moved-pageId>&spaceKey=<target-space-key>&targetTitle=<target-title-of-parent-page>&position=append' \
-H 'authorization: Basic <encoded-username-password>' \ 
-H 'x-atlassian-token: no-check'

    Pour déplacer une page de haut niveau de la page dans l'espace

    curl -X GET \
'<your-confluence-base-URL>/pages/movepage.action?pageId=<page-to-be-moved-pageId>&spaceKey=<target-space-key>&position=topLevel' \...
    InformationsquelleAutor Arjun Shukla