Check issues against JQL

POST

/rest/api/3/jql/match

Checks whether one or more issues would be returned by one or more JQL queries.

Permissions required: None, however, issues are only matched against JQL queries where the user has:

Browse projects project permission for the project that the issue is in.

If issue-level security is configured, issue-level security permission to view the issue.

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'http:///rest/api/3/jql/match' \
--header 'Content-Type: application/json' \
--data-raw '{
    "issueIds": [
        10001,
        1000,
        10042
    ],
    "jqls": [
        "project = FOO",
        "issuetype = Bug",
        "summary ~ \"some text\" AND project in (FOO, BAR)"
    ]
}'

响应示例

200 - 成功示例

{"matches":[{"matchedIssues":[10000,10004],"errors":[]},{"matchedIssues":[100134,10025,10236],"errors":[]},{"matchedIssues":[],"errors":[]},{"matchedIssues":[],"errors":["Invalid JQL: broken = value"]}]}

请求参数

Body 参数application/json

示例

返回响应

🟢200Returned if the request is successful.

application/json

Body

🟠400Returned if `jqls` exceeds the maximum number of JQL queries or `issueIds` exceeds the maximum number of issue IDs.

修改于 2023-07-12 08:28:11

Get issue picker suggestions

Search for issues using JQL (GET)