View Source

GET	com.easesolutions.jira.plugins.requirements/1.0/projects	Get all projects enabled in Requirements
POST	com.easesolutions.jira.plugins.requirements/1.0/projects/enable/prjKey	Enable a project in Requirements
POST	com.easesolutions.jira.plugins.requirements/1.0/projects/disable/prjKey	Disable a project in Requirements
PUT	com.easesolutions.jira.plugins.requirements/1.0/setsuspect/projectId	Set a suspect.
POST	com.easesolutions.jira.plugins.requirements/1.0/prjKey/suspectconfiguration	Trigger saving a suspect configuration.
GET	com.easesolutions.jira.plugins.requirements/1.0/prjKey/suspectconfigurations	Returns all suspect configuration in project.
PUT	com.easesolutions.jira.plugins.requirements/1.0/prjKey/suspectconfiguration/id	Trigger editing a suspect configuration.
DELETE	com.easesolutions.jira.plugins.requirements/1.0/prjKey/suspectconfiguration/id	Trigger deleting a suspect configuration.

Get all projects enabled in Requirements.

REQUEST

POST

/rest/com.easesolutions.jira.plugins.requirements/1.0/projects

RESPONSES

- Returned if the project is successfully enabled

[
  {
    "prjID": 10000,
    "prjKey": "TP",
    "prjName": "Test Project"
  }
]

- Returned if an error occurs while retrieving all enabled projects in Requirements

- Returned if invalid user credentials, or the user has no permission

- Returned if the license is invalid or has expired, or incompatible JIRA version

Enable a project in Requirements.

REQUEST

POST

/rest/com.easesolutions.jira.plugins.requirements/1.0/projects/enable/prjKey

PARAMETERS

parameter	type	description
prjKey*	string	The project key of the project to be enabled.

RESPONSES

- Returned if the project is successfully enabled

{ 
	"prjKey": "SC", 
	"prjName": "Sand Castle", 
	"issueCount": 34, 
	"success": true 
}

- Returned if the project is invalid or an error occurs while activating the project

- Returned if invalid user credentials, or the user has no permission

- Returned if the license is invalid or has expired, or incompatible JIRA version

Disable a project in Requirements.

REQUEST

POST

/rest/com.easesolutions.jira.plugins.requirements/1.0/projects/disable/prjKey

PARAMETERS

parameter	type	description
prjKey*	string	The project key of the project to be disabled.

RESPONSES

- Returned if the project is sucessfully disabled

{
  "prjKey": "SC",
  "prjName": "Sand Castle",
  "issueCount": 34,
  "success": true
}

- Returned if the project is invalid or an error occurs while disabling the project

- Returned if invalid user credentials, or the user has no permission

- Returned if the license is invalid or has expired, or incompatible JIRA version

Set a suspect.

REQUEST

PUT
com.easesolutions.jira.plugins.requirements/1.0/setsuspect/projectId

Sample request data JSON:

{

"issueSourceKey": "TEST-1",

"issueDestinationKey" "TEST-2",

"direction": "in",

"linkTypeId": 10000,

"suspect": true

}

issueSourceKey (string): The source's issue key

issueDestinationKey (string): The destination's issue key

direction (string): in/out/in-out

linkTypeId (long): -1(All), 10000(Blocks), 10001(Clones), 10002(Duplicate) and/or 10003(Relates)

suspect (boolean): is a suspect

PARAMETERS

parameter	type	description
projectId*	long	The project's ID to be used
data	object	The JSON object of suspect data. Please refer above for the example and properties definition.

RESPONSE

Response	Details
	Returned on successful operation.
	Returned when project is null. Project is invalid or hasn't been assigned to the Requirements for JIRA plugin
	Returned when either suspect data's srcKey and destKey are null.
	Returned on failed operation.

Trigger saving a suspect configuration.

REQUEST

POST

/rest/com.easesolutions.jira.plugins.requirements/1.0/prjKey/suspectconfiguration

Sample request data JSON:
{
"configName": "testName",
"notifyAssignee": false,
"notifyReporter": false,
"notifyProjectLead": false,
"userKeys": ["admin", "user1"],
"linkTypeIds":["10002", "10003"],
"useAllLinktypes":false,
"suspectConfigItems":[
{
"field": "assignee",
"stream":"up"
},
{
"field": "customfield_10003",
"stream": "up"
}],
"scope":"up"
}


configName (string): The suspect configuration name
notifyAssignee (boolean): True to notify assignee, otherwise false
notifyReporter (boolean): True to notify reporter, otherwise false
notifyProjectLead (boolean): True to notify project lead, otherwise false
userKeys (string array): The list of user ids to be notified
linkTypeIds (string array): The list of link type ids. Possible values are: -1(All), 10000(Blocks), 10001(Clones), 10002(Duplicate) and/or 10003(Relates)
useAllLinktypes (boolean): True if use all link types, otherwise false
suspectConfigItems (object array): The list of fields that trigger a suspect
     field (string): The field id
     stream (string): The scope of the configuration. It must have the same value with "scope"
scope (string): The scope of the configuration. Possible values are: "up", "down" or "both"

PARAMETERS

parameter	type	description
prjKey*	string	The project key to be configured.
data	object	The JSON object of suspect configuration data. Please refer above for the example and properties definition.

RESPONSES

- Returned if suspect configuration is successfully saved.

Suspect Configuration saved for SC

- Returned if the project is invalid, scope is invalid, link type id is invalid, list of users is invalid or contains an invalid user key, or list of fields is invalid or contains an invalid field

- Returned if invalid user credentials, or the user has no permission to use the Requirements for JIRA plugin

- Returned if the license is invalid or has expired, incompatible JIRA version, the project is not configured for Requirements for JIRA, or no permission to create suspect configuration

- Returned if the project is not found

- Returned if an error occurs while creating suspect configuration

Returns all suspect configuration in project.

REQUEST

GET

/rest/com.easesolutions.jira.plugins.requirements/1.0/prjKey/suspectconfigurations

PARAMETERS

parameter	type	description
prjKey*	string	The project key to be configured.

RESPONSES

- Returned if suspect configuration is successfully deleted.

[
  {
    "configId": 1,
    "configName": "name 1",
    "projectId": 10001,
    "notifyAssignee": true,
    "notifyReporter": true,
    "notifyProjectLead": true,
    "userKeys": [],
    "linkTypeIds": [],
    "useAllLinktypes": true,
    "suspectConfigItems": [
      {
        "stream": "both",
        "field": "  <all fields>"
      }
    ],
    "scope": "both"
  }
]

- Returned if the project is invalid.

- Returned if invalid user credentials, or the user has no permission to use the Requirements for JIRA plugin

- Returned if the license is invalid or has expired, incompatible JIRA version, the project is not configured for Requirements for JIRA, or no permission to create suspect configuration

- Returned if the project is not found

- Returned if an error occurs while retrieving all suspect configuration

Trigger editing a suspect configuration.

REQUEST

PUT

/rest/com.easesolutions.jira.plugins.requirements/1.0/prjKey/suspectconfiguration/id

Sample request data JSON:
{
"configName": "testName",
"notifyAssignee": false,
"notifyReporter": false,
"notifyProjectLead": false,
"userKeys": ["admin", "user1"],
"linkTypeIds":["10002", "10003"],
"useAllLinktypes":false,
"suspectConfigItems":[
{
"field": "assignee",
"stream":"up"
},
{
"field": "customfield_10003",
"stream": "up"
}],
"scope":"up"
}


configName (string): The suspect configuration name
notifyAssignee (boolean): True to notify assignee, otherwise false
notifyReporter (boolean): True to notify reporter, otherwise false
notifyProjectLead (boolean): True to notify project lead, otherwise false
userKeys (string array): The list of user ids to be notified
linkTypeIds (string array): The list of link type ids. Possible values are: -1(All), 10000(Blocks), 10001(Clones), 10002(Duplicate) and/or 10003(Relates)
useAllLinktypes (boolean): True if use all link types, otherwise false
suspectConfigItems (object array): The list of fields that trigger a suspect
     field (string): The field id
     stream (string): The scope of the configuration. It must have the same value with "scope"
scope (string): The scope of the configuration. Possible values are: "up", "down" or "both"

PARAMETERS

parameter	type	description
prjKey*	string	The project key to be configured.
id*	string	The suspect configuration id.
data	object	The JSON object of suspect configuration data. Please refer above for the example and properties definition.

RESPONSES

- Returned if suspect configuration is successfully udpated.

Suspect Configuration saved for SC

- Returned if the project is invalid, scope is invalid, link type id is invalid, list of users is invalid or contains an invalid user key, or list of fields is invalid or contains an invalid field

- Returned if invalid user credentials, or the user has no permission to use the Requirements for JIRA plugin

- Returned if the license is invalid or has expired, incompatible JIRA version, the project is not configured for Requirements for JIRA, or no permission to create suspect configuration

- Returned if the project is not found

- Returned if an error occurs while editing configuration

Trigger delete a suspect configuration.

REQUEST

DELETE

/rest/com.easesolutions.jira.plugins.requirements/1.0/prjKey/suspectconfiguration/id

PARAMETERS

parameter	type	description
prjKey*	string	The project key to be configured.
id*	string	The suspect configuration id.

RESPONSES

- Returned if suspect configuration is successfully deleted.

Suspect Configuration deleted for SC

- Returned if the project is invalid or id is invalid

- Returned if invalid user credentials, or the user has no permission to use the Requirements for JIRA plugin

- Returned if the license is invalid or has expired, incompatible JIRA version, the project is not configured for Requirements for JIRA, or no permission to create suspect configuration

- Returned if the project is not found

- Returned if an error occurs while deleting suspect configuration