Confluence API

This project contains a Node.js module which wraps Atlassian's Confluence API.

Getting Started

Install confluence-api via npm:

$ npm install confluence-api

Create an instance of Confluence by providing a username and password (or token) and a baseUrl used for all future requests. Confluence uses basic http authentication. For instance:

var Confluence = require("confluence-api");
var config = {
    username: "testuser",
    password: "test-user-pw-or-rest-api-token",
    baseUrl:  "https://confluence-api-test.atlassian.net/wiki",
    version: 4 // Confluence major version, optional
};
var confluence = new Confluence(config);
confluence.getContentByPageTitle("space-name", "page-title", function(err, data) {
    // do something interesting with data; for instance,
    // data.results[0].body.storage.value contains the stored markup for the first
    // page found in space 'space-name' matching page title 'page-title'
    console.log(data);
});

Confluence currently exposes the following API...

Confluence

Kind: global class this: {Confluence}

• Confluence
  • new Confluence(config)
  • .getSpace(space, callback)
  • .getSpaceHomePage(space, callback)
  • .getContentById(id, callback)
  • .getCustomContentById(options, callback)
  • .getContentByPageTitle(space, title, callback)
  • .postContent(space, title, content, parentId, callback, representation)
  • .putContent(space, id, version, title, content, callback, minorEdit, representation)
  • .deleteContent(id, callback)
  • .getAttachments(space, id, callback)
  • .createAttachment(space, id, filepath, callback)
  • .updateAttachmentData(space, id, attachmentId, filepath, callback)
  • .getLabels(id, callback)
  • .postLabels(id, labels, callback)
  • .deleteLabel(id, label, callback)
  • .search(query, callback)

new Confluence(config)

Construct Confluence.

confluence.getSpace(space, callback)

Get space information.

Kind: instance method of Confluence

confluence.getSpaceHomePage(space, callback)

Get space home page.

Kind: instance method of Confluence

confluence.getContentById(id, callback)

Get stored content for a specific space and page title.

Kind: instance method of Confluence

confluence.getCustomContentById(options, callback)

Get stored content for a specific page id with optional custom expanders.

Kind: instance method of Confluence

confluence.getContentByPageTitle(space, title, callback)

Get stored content for a specific space and page title.

Kind: instance method of Confluence

confluence.postContent(space, title, content, parentId, callback, representation)

Post content to a new page.

Kind: instance method of Confluence

confluence.putContent(space, id, version, title, content, callback, minorEdit, representation)

Put/update stored content for a page.

Kind: instance method of Confluence

confluence.deleteContent(id, callback)

Delete a page.

Kind: instance method of Confluence

confluence.getAttachments(space, id, callback)

Get attachments

Kind: instance method of Confluence

confluence.createAttachment(space, id, filepath, callback)

This allows you to post attachments to the pages you create.

Kind: instance method of Confluence

confluence.updateAttachmentData(space, id, attachmentId, filepath, callback)

This allows you to update posted attachments data

Kind: instance method of Confluence

confluence.getLabels(id, callback)

Get labels from content

Kind: instance method of Confluence

confluence.postLabels(id, labels, callback)

Post content labels to a existing page.

Kind: instance method of Confluence

confluence.deleteLabel(id, label, callback)

Delete a label from a page.

Kind: instance method of Confluence

confluence.search(query, callback)

Search by query

Kind: instance method of Confluence

request

Node.js wrapper for Atlassian's Confluence API. See https://developer.atlassian.com/confdev/confluence-rest-api

Copyright (c) 2015, John Duane Released under the MIT License