使用Jira REST API

时间:2016-03-02 12:30:07

标签: php json rest curl jira-rest-api

我想使用Jira REST API,但一直没有成功。

Jira网站提供以下请求网址:

curl -D- -u fred:fred -X POST --data {see below} -H "Content-Type: application/json" http://localhost:8090/rest/api/2/issue/ 

这是json数组,它位于一个名为collector.json的文件中:

"fields": [
            {
                "project":
                        {
                            "key": "ATL"
                        },
                "summary": "REST ye merry TEST.",
                "description": "Creating of an issue using project keys and issue type names using the REST API",
                "issuetype": {
                                "name": "Task"
                             }
            }
        ]

}

以下是代码:

<?php
include_once "collector.php";

$jiraValues = jsonArray("collector.json");
$jira_url = "http://jira.howareyou.org:8091/rest/api/2/issue/createmeta";
$jiraString = json_encode($jiraValues);

$request = curl_init($jira_url); // initiate curl object
curl_setopt($request, CURLOPT_HEADER, 0); // set to 0 to eliminate header info from response
curl_setopt($request, CURLOPT_RETURNTRANSFER, 1); // Returns response data instead of TRUE(1)
curl_setopt($request, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);

curl_setopt($request, CURLOPT_HTTPHEADER, array('Content-Type: application/json'));
curl_setopt($request, CURLOPT_ENCODING, "");
curl_setopt($request, CURLOPT_SSL_VERIFYHOST, 2);
curl_setopt($request, CURLOPT_RETURNTRANSFER, true);
curl_setopt($request, CURLOPT_POSTFIELDS, $jiraString); // use HTTP POST to send form data
curl_setopt($request, CURLOPT_SSL_VERIFYPEER, FALSE); // uncomment this line if you get no gateway response.
curl_setopt($request, CURLOPT_URL, $jira_url);

$json_raw = curl_exec($request); // execute curl post and store results in $json_raw

curl_close($request); // close curl object

// This line takes the response and breaks it into an array using the specified delimiting character
$jira_response = json_decode($json_raw, TRUE);

print_r($jira_response);

当我运行它时,没有任何事情发生。我没有得到反馈。

我发现它here,并用我的有效信息替换了这些信息。

1 个答案:

答案 0 :(得分:1)

首先定义一些有用的全局变量来帮助:

define('JIRA_URL', 'http://jira.howareyou.org:8091');
define('USERNAME', '');
define('PASSWORD', '');

然后我们需要定义一个post方法:

function post_issue($data) {
    $jdata = json_encode($data);
    $ch = curl_init();
    curl_setopt_array($ch, array(
        CURLOPT_POST => 1,
        CURLOPT_URL => JIRA_URL . '/rest/api/2/issue/createmeta' . $resource,
        CURLOPT_USERPWD => USERNAME . ':' . PASSWORD,
        CURLOPT_POSTFIELDS => $jdata,
        CURLOPT_HTTPHEADER => array('Content-type: application/json'),
        CURLOPT_RETURNTRANSFER => true
    ));
    $result = curl_exec($ch);
    curl_close($ch);
    return json_decode($result);
}

然后我们如何使用它就像这样:

创建新问题

$new_issue = array(
    'fields' => array(
        'project' => array('key' => 'TIS'),
        'summary' => 'Test via REST',
        'description' => 'Description of issue goes here.',
        'priority' => array('name' => 'Blocker'),
        'issuetype' => array('name' => 'Task'),
        'labels' => array('a','b')
    )
);

调用我们先前制作的函数传递新问题:

$result = post_issue($new_issue);
if (property_exists($result, 'errors')) {
    echo "Error(s) creating issue:\n";
    var_dump($result);
} else {
    echo "New issue created at " . JIRA_URL ."/browse/{$result->key}\n";
}

通过REST发布新问题的基本示例

注意:可能需要稍微配置Jira API网址