Java接口整理

1.登录：cgjr/backstage/login.json

输入参数：

参数名	参数类型	说明
mobile	string	手机号（新增参数）
account	string	登录账号
password	string	密码

输出参数：

参数名	参数类型	说明
name	string	用户名
token	string	token
userId	int	用户id
companyName	string	加盟商名称
roleList	array	角色列表
id	int	角色id
roleNo	string	角色编码
name	string	角色名称

备注: 产品的设计图上面，一个用户即可用是业务员也可用是外访员，所以角色列表里面要过滤掉业务员和外访员以外的角色。
后面查询任务完成个数和处理中、已完成任务的接口，都应该多加一个角色id的参数.

2.查询任务个数 ：cgjr/order/getorderortaskcount.json

输入参数：

参数名	参数类型	说明
roleNo	string	角色编码
productCode	string	产品码

输出参数：

参数名	参数类型	说明
taskWorkCount	int	处理中的任务个数
taskOverCount	int	已完成的任务个数

备注：

• 接口新增参数roleNo；
• 原来返回的数据是list，可以优化下。

3.接单：cgjr/order/createorder.json

输入参数：

参数名	参数类型	说明
productCode	string	产品码
name	string	姓名
phoneNo	string	手机号
address	string	地址
loanAmount	string	借款金额
creditDates	string	借款期限
useFor	string	借款用途

输出参数：

参数名	参数类型	说明
productCode	string	产品码
orderNo	string	订单号
taskId	string	任务id
processInstanceId	string	流程实例ID
dataStage	int	流程节点

备注：

• 原业务逻辑dataStage=1对应业务员 2对应外访员 3总经理
• 接单成功需要跳转订单详情页面，上面返回的参数都是订单详情页面需要的。
• 借款金额和期限需要新增一个接口返回：返回结果data里面放两个数组就可以吧。

4.处理中或已完成任务：cgjr/activiti/query_task.json

输入参数：

参数名	参数类型	说明
roleNo	string	角色编码-用来确定是业务还是外访
status	string	1处理中 2审核中 3已放款
targetPage	string	第几页
pageSize	string	每页返回个数

输出参数：data里面返回一个数组

参数名	参数类型	说明
taskName	string	任务结点名称
startTime	long	任务开始时间
memberPhone	string	手机号码
orderNo	string	订单号
address	string	地址
memberName	string	姓名

备注：

• 该接口参数新增一个roleNo；
• 返回结果参数去掉了一个assignee；
• 返回格式data套data规范下；

• 已完成任务需要新增一个参数。
  如图。新增的参数用来标识获取审核中或已放款的列表。
  返回的时间审核中是订单创建时间，已放款的时间是放款时间。

  
  
  

  image.png

5.订单详情：cgjr/order/getorderforapp.json

输入参数：

参数名	参数类型	说明
orderNo	string	订单号
dataStage	string	流程节点

输出参数：

参数名	参数类型	说明
loanAmount	string	借款金额
loanDay	string	借款天数
used	string	借款用途
backMsg	string	流程被回退的审批信息
msg	string	模块信息完整性校验（备注有详解）	backMsg	string	流程被回退的审批信息
resourcesJson	array	大json

备注：

• 之前的信息完整性校验是在后端处理的，每当用户上传完一个模块的信息，回到订单详情页会再次调用本接口去获取msg。用户提交的时候，会通过msg来提示用户信息输入是否完整。
• resourcesJson下面的数据结构

参数名	参数类型	说明
name	string	标题
children	array	模块列表

• children下面的数据结构

参数名	参数类型	说明
name	string	模块组标题
children	array	模块分组列表
isCheck	int	0没有限制 1至少选填一项

isCheck是新增的字段：

image.png

• children下面的数据结构

参数名	参数类型	说明
hasData	boolean	是否有数据
name	string	模块标题
englishName	string	模块英文标题
uri	string	模块图标url
templateId	int	模块id
isMust	int	是否必填 1必填 0选填

isMust页面标记是否必填。

image.png

6.提交审核：cgjr/order/approval.json

输入参数：

参数名	参数类型	说明
type	int	通过1 拒绝2
memo	string	审核内容
isNext	int	是否到下个节点
orderNo	string	订单号

备注：

• type原来有通过和拒绝，现在没有拒绝，统一改成了提交。
• isNext 业务员和外访员为1，总经理为0。

输出参数：

返回成功的标识即可，不需要返回任何数据。

7.上传图片文件: cgjr/fileupload/upload_file.json

建议改成直接上传file文件。

8.添加或更新模块数据cgjr/order/updatetemplatedata.json

输入参数：

参数名	参数类型	说明
type	int	通过1 拒绝2
orderNo	int	订单号
groupId	int	groupId
json	array	表单数据

备注：
json里面的内容格式：

参数名	参数类型	说明
type	int	通过1 拒绝2
sourceValue	string	值
infoEnglishName	string	key
listNum	int	列表的第几项
nextListNum	int	下一个索引

• listNum：如果是新增 listNum是在前面的基础上+1，如果是更新listNum保持不变。
• nextListNum：如果sourceValue是图片，nextListNum是图片数组的索引。如果是文本，nextListNum=0。

9.获取页面的数据cgjr/order/gettemplatedata.json

输入参数：

参数名	参数类型	说明
orderNo	int	订单号
templateId	int	templateId
groupId	int	groupId

输出参数：data是List>结构

SourceInfo的字段类型如下：

参数名	参数类型	说明
infoEnglishName	int	字段的英文key
infoName	int	字段的中文key
sourceValue	int	字段值
infoType	int	字段的类型
isNotNull	int	0不能为空 1可以为空
viewType	int	0文字 1图片
options	string	选项列表值

备注：

• infoEnglishName 提交表单信息的参数
• infoName 页面动态显示的key值
• sourceValue 没有数据的时候就是空 有的时候就返回
• infoType 的类型 ：
  0:文本输入框 1:数字输入框 2:地址框 3:时间输入框
  4:选项框 5:固定值 6:大文本框
  -options：当viewType=4的时候 options不为空，格式例如：农业,非农业。
  客户端通过逗号分隔转化为数组。

10.删除数据cgjr/order/deletetemplatedata.json

输入参数：

参数名	参数类型	说明
orderNo	int	订单号
listNum	int	列表第几项
groupId	int	groupId

只有家庭成员列表、车辆列表、商品房、自建房列表有删除功能。

输出参数：

返回成功标识即可。

11.外访评价 cgjr/evaluate/evaluate.json

输入参数：

参数名	参数类型	说明
orderNo	int	订单号

输出参数：

data里面直接放一个string类型的文本即可。

需要新增的接口：

• 业务接单：获取该业务员对应的加盟商配置的借款期间和借款金额。理论上传参只用userid就可以了。
• 修改密码： 参数 userid password
• 查询任务接口（按姓名或手机号查询任务列表）