工单请求列表
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.jsoncurl 示例
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": "新模板",
... }
]}