文档
测试

24. 工单列表

POST
/api/serviceJob/getServiceJobByList

接口描述

工单列表

请求头

参数名
类型
描述
必填
content-Type
string
application/json;charset=utf-8
必填

请求参数

参数名
类型
描述
必填
timestamp
long
时间戳(毫秒)
必填
noncestr
string
8位随机数
必填
sign
string
参数签名
必填
body
object
参数数据
必填
token
string
用户登录成功返回token
必填
userId
string
用户id
必填
pager
Object
分页对象
必填
currentPage
int
当前页(初始传1)
必填
pageSize
int
页大小(可传)
必填
jobTypes
Object
工单列表查询条件包含:普通工单:[8,9,10],报警工单:[3,7,11],换电工单:[2], 故障救援:[4] 刷选条件:警报:[3,4,11] -> 状态【3.断电工单,7.偷到工单,11.忘光锁座】 换电:[1,2,5] -> 状态【1.低电量, 2.建议换电,5紧急换电】 特殊: [4,6] -> 状态【4.道路救援,6.故障工单】 日常:[8,9,10] -> 状态【8.查看日常,9.巡检工单,10.维护工单】 (注意,所有的数据格式为数组[1,2,3,..])
必填
progresss
Object
工单列表查询条件,处理中:[1],未认领:[0] 刷选条件:进度:[0,1,2,3] -> 状态【0.未领取,1.处理中,2.已处理,3.已关闭】 (注意,所有的数据格式为数组[1,2,3,..])
必填
sources
Object
帅选条件:[1,2,3] -> 来源【1.系统,2.客服,3.运维】 (注意,所有的数据格式为数组[1,2,3,..])
必填

响应参数

参数名
类型
描述
必填
timestamp
long
时间戳(毫秒)
必填
sign
string
响应数据签名
必填
body
object
响应数据
必填
code
string
响应状态码 10000成功 其他失败
必填
msg
string
响应描述(当code不为1000返回信息)
必填
data
Object
数据(当code为1000返回数据)
必填
totalSize
string
总条数
必填
serviceJob
Object
数据对象
必填
id
string
工单id
必填
bikeNum
string
车辆编号
必填
battery
string
电量
必填
handler
string
处理人
必填
progressDesc
string
进度描述
必填
sourceDesc
string
来源描述
必填
createTime
string
创建时间
必填
bikeOnlineDesc
string
车辆状态
必填
jobTypeDesc
string
工单类型
必填
jobDesc
string
工单描述
必填

说明 / 示例

#### 查询参数说明 ```type jobTypes: 工单列表查询条件包含: 普通工单:[8,9,10],报警工单:[3,7,11],换电工单:[2], 故障救援:[4] 刷选条件: 警报:[3,4,11] -> 状态【3.断电工单,7.偷到工单,11.忘光锁座】 换电:[1,2,5] -> 状态【1.低电量, 2.建议换电,5紧急换电】 特殊: [4,6] -> 状态【4.道路救援,6.故障工单】 日常:[8,9,10] -> 状态【8.查看日常,9.巡检工单,10.维护工单】 (注意,所有的数据格式为数组[1,2,3,..]) progresss: 工单列表查询条件包含: 处理中:[1],未认领:[0] 刷选条件: 进度:[0,1,2,3] -> 状态【0.未领取,1.处理中,2.已处理,3.已关闭】 (注意,所有的数据格式为数组[1,2,3,..]) source: 帅选条件: 来源:[1,2,3] -> 来源【1.系统,2.客服,3.运维】 (注意,所有的数据格式为数组[1,2,3,..]) ``` ## 1.请求示例 POST https://{host}:{port}/api/serviceJob/getServiceJobByList Content-Type: application/json ```json { "sign": "ae4228b2c05429d36c02d0968b037de3", "body": { "pager": { "currentPage": 1 }, "userId": "b1228f74f5124dc592de23d3caec57ed", "token": "qoa64tpab1228f74f5124dc592de23d3caec57ed" }, "noncestr": "tl7nhpp9", "timestamp": 1602742192163 } ``` ## 2.响应样例 Status Code: 1000 ok Content-Type: application/json ```json { "body": { "code": "10000", "data": { "totalSize": 2, "serviceJob": [ { "progressDesc": "等待领取", "handler": "", "sourceDesc": "系统", "createTime": "2020.10.14 15:10", "bikeOnlineDesc": "上线", "bikeNum": "000004", "battery": "", "jobDesc": "查看工单" }, { "progressDesc": "等待领取", "handler": "", "sourceDesc": "系统", "createTime": "2020.10.14 15:10", "bikeOnlineDesc": "上线", "bikeNum": "000004", "battery": "", "jobDesc": "低电量工单" } ] } }, "timestamp": 1602742221979, "sign": "846e6185ce58fb0a9c9615a2ca902a72" } ```