A node.js module, which provides an object oriented wrapper for the JIRA REST API.
This library is built to support version 2.0.alpha1
of the JIRA REST API.
This library is also tested with version 2
of the JIRA REST API
It has been noted that with Jira OnDemand, 2.0.alpha1
does not work, devs
should revert to 2
. If this changes, please notify us.
JIRA REST API documentation can be found here
Install with the node package manager npm:
$ npm install jira
or
Install via git clone:
$ git clone git://git://github.com/steves/node-jira.git
$ cd node-jira
$ npm install
Find the status of an issue.
JiraApi = require('jira').JiraApi;
var jira = new JiraApi('https', config.host, config.port, config.user, config.password, '2.0.alpha1');
jira.findIssue(issueNumber, function(error, issue) {
console.log('Status: ' + issue.fields.status.name);
});
Currently there is no explicit login call necessary as each API call uses Basic Authentication to authenticate.
JiraApi options:
protocol<string>
: Typically 'http:' or 'https:'host<string>
: The hostname for your jira serverport<int>
: The port your jira server is listening on (probably80
or443
)user<string>
: The username to log in withpassword<string>
: Keep it secret, keep it safeJira API Version<string>
: Known to work with2
and2.0.alpha1
verbose<bool>
: Log some info to the console, usually for debuggingstrictSSL<bool>
: Set to false if you have self-signed certs or something non-trustworthy
- Authentication
- Projects
- Pulling a project
- List all projects viewable to the user
- List Components
- List Fields
- List Priorities
- Versions
- Pulling versions
- Adding a new version
- Pulling unresolved issues count for a specific version
- Rapid Views
- Find based on project name
- Get the latest Green Hopper sprint
- Gets attached issues
- Issues
- Add a new issue
- Update an issue
- Transition an issue
- Pulling an issue
- Issue linking
- Add an issue to a sprint
- Get a users issues (open or all)
- List issue types
- Search using jql * Set Max Results * Set Start-At parameter for results
- Add a worklog
- Add a comment
- Transitions
- List
- Users
- Search
- Refactor currently implemented APIs to be more Object Oriented
- Refactor to make use of built-in node.js events and classes
- 0.8.1 Expanding the transitions options (thanks to eduardolundgren)
- 0.8.0 Ability to search users (thanks to eduardolundgren)
- 0.7.2 Allows HTTP Code 204 on issue update edit (thanks to eduardolundgren)
- 0.7.1 Check if body variable is undef (thanks to AlexCline)
- 0.7.0 Adds list priorities, list fields, and project components (thanks to eduardolundgren)
- 0.6.0 Comment API implemented (thanks to StevenMcD)
- 0.5.0 Last param is now for strict SSL checking, defaults to true
- 0.4.1 Now handing errors in the request callback (thanks mrbrookman)
- 0.4.0 Now auto-redirecting between http and https (for both GET and POST)
- 0.3.1 Request is broken, setting max request package at 2.15.0
- 0.3.0 Now Gets Issues for a Rapidview/Sprint (thanks donbonifacio)
- 0.2.0 Now allowing startAt and MaxResults to be passed to searchJira, switching to semantic versioning.
- 0.1.0 Using Basic Auth instead of cookies, all calls unit tested, URI creation refactored
- 0.0.6 Now linting, preparing to refactor
- 0.0.5 JQL search now takes a list of fields
- 0.0.4 Added jql search
- 0.0.3 Added APIs and Docco documentation
- 0.0.2 Initial version