bitbucket-server-nodejs

Rest client for Atlassian client

Provides access to some of client's APIs.

Initialising Client

Supports Basic Auth and OAuth

var Client = require('bitbucket-server-nodejs').Client;

var auth = {
    "type": "basic",
    "username": "username",
    "password": "password"
};
                - OR -
var auth = {
    "type": "oauth",
    "consumer_secret": "consumer_secret",
    "signature_method": "signature_method",
    "token": "token",
    "token_secret": "token_secret"
};

var client = new Client(
    'http://localhost:7990/rest/api/1.0/',
    auth
);

APIS

projects

Get all projects.

client.projects.get(); // Promise

repos

Get all repos for a project.

client.repos.get(projectKey); // Promise

Get all repos for all projects.

client.repos.getCombined(); // Promise

branches

Get all branches for a repo.

client.branches.get(projectKey, repoKey); // Promise

To get branches from a user repo rather than a project repo, use user's slug as the project key, prepended by '~'.

client.branches.get('~userslug', repoKey); // Promise

pull requests

Get all pull requests for a repo.

client.prs.get(projectKey, repoSlug); // Promise

Get all pull requests for a project.

client.prs.getCombined(projectKey); // Promise

Get all pull requests on all projects.

client.prs.getCombined(); // Promise

Get all pull requests by a specific author.

client.prs.getCombined(null, null, { author: "ben" }); // Promise

Get all pull requests in a specific state (defaults OPEN).

client.prs.getCombined(null, null, { state: "MERGED" }); // Promise

Possible states: ALL, OPEN, DECLINED or MERGED.

hooks

Get all hooks for a repo.

client.hooks.get(projectKey, repoSlug); // Promise

Get all pre-recieve hooks.

client.hooks.getPreReceive(projectKey, repoSlug); // Promise

Get all post-recieve hooks.

client.hooks.getPostReceive(projectKey, repoSlug); // Promise

Get details for a single hook.

client.hooks.getHook(projectKey, repoSlug, hookKey); // Promise

settings

Get user's settings. Username and Password must be valid.

client.settings.get(username); // Promise

API Coverage

• /rest/api/1.0/projects [GET]
• /rest/api/1.0/projects/{projectKey}/repos [GET]
• /rest/api/1.0/projects/{projectKey}/repos/{repositorySlug} [GET]
• /rest/api/1.0/projects/{projectKey}/repos/{repositorySlug}/pull-requests [GET]
• /rest/api/1.0/projects/{projectKey}/repos/{repositorySlug}/settings/hooks [GET]
• /rest/api/1.0/projects/{projectKey}/repos/{repositorySlug}/settings/hooks/{hookKey}/enabled [PUT]