Search this space

Live demo

Want to see a live demo and learn what this Connector can do? Join our jam sessions!

Page tree

If you are looking for documentation for the new Salesforce & JIRA Cloud Connector, click here.

Skip to end of metadata
Go to start of metadata

Introduction


In addition to Endpoints, the Connector provides the ability to create JIRA Issues using Connector REST APIs, which can be used in an Apex class.

Consult these related pages for more examples:

Page Contents

Also Available on Bitbucket

All Apex Class codes provided are also provided on our Bitbucket Repository for your reference.

The Connector REST API Definition


The API can be described as:

Title

Item

HTTP Method

POST

URL

<JIRA URL>/rest/customware/connector/1.0/{systemId}/{objectType}/{objectId}/issue/create.{accept}

Produces

APPLICATION_JSON

Consumes

APPLICATION_JSON

Data Input

{
"project" : "<project key>",
"issueType" : "<issue type>",
}

Using cURL, it can be constructed like this:

curl -i -H "Content-Type: application/json" -H "Authorization: Basic <64bit encoded username and password>" -X POST https://example.com/rest/customware/connector/1.0/1/Case/50090002N5r6/issue/create.json -d'{"project":"SFDC", "issueType":"1"}'

Note

This setup can only be used if your JIRA instance is not behind a firewall.

Detailed Description


The Connector provides three actions that can be performed in calling its REST APIs, namely:

  1. Create
  2. Synchronize
  3. Fetch

They are all using a similar pattern of endpoint.

Endpoint: <JIRA URL>/rest/customware/connector/1.0/{systemId}/{objectType}/{objectId}/issue/{action}.{accept}

Action

HTTP method

Produces

{action}

Example

Data Input

Create

POST

APPLICATION_JSON

create

https://example.com/rest/customware/connector/1.0/1/Case/50090002N5r6/issue/create.json


"project" : "<project key>", 
"issueType" : "<issue type>", 
}

Synchronize

PUT

APPLICATION_JSON

synchronize

https://example.com/rest/customware/connector/1.0/1/Case/50090002N5r6/issue/synchronize.json

-

Fetch

GET

APPLICATION_JSON

fetch

https://example.com/rest/customware/connector/1.0/1/Case/50090002N5r6/issue/fetch.json

-

 

  • No labels