工单请求列表
GET /apiv2/requests.json
获取当前用户的工单请求列表,即发起人为当前用户的工单,默认按工单编号升序排列
调用权限
end user
请求参数
created_order:按创建时间排序规则,可选值:asc,desc (默认为desc)
updated_order:按更新时间排序规则,可选值:asc,desc
status_order:按工单状态排序规则,可选值:asc,desc
field_order: 按自定义字段属性排序规则,参数格式:field_690_asc,或field_690_desc。其中field_690为该工单的自定义字段name,可以通过 工单自定义字段接口获得
也可以使用如下API:
获取状态小于已解决的工单
GET /apiv2/requests/open.json
获取状态已解决和已关闭的工单
Name | Type | Required | Comment |
---|---|---|---|
start | string | no | 指定开始时间:2019-01-01 |
end | string | no | 指定结束时间:2019-04-08 |
range_field | string | no | 指定筛选范围 resolved、closed。 当字段值为resolved:结果则是指定时间段的解决工单列表; 为closed:结果则是指定时间段的关闭工单列表 |
GET /apiv2/requests/solved.json
获取指定用户的工单请求(调用权限 agent)
GET /apiv2/users/{id}/requests.json
获取指定公司组织的工单请求(调用权限 agent)
GET /apiv2/organizations/{id}/requests.json
curl 示例
curl https://{subdomain}.kf5.com/apiv2/requests.json \ -v -u {email_address}/token:{api_token}
返回示例
Status: 200 OK{ "requests": [ { "id": 33, "status": "open", "title": "here is a bug", "template_id": "100025", "template": "新模板", ... }, { "id": 34, "status": "closed", "title": "here is another bug", "template_id": "100025", "template": "新模板", ... } ]}