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<List<SourceInfo>>结构

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
  • 查询任务接口(按姓名或手机号查询任务列表)
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 205,033评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,725评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,473评论 0 338
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,846评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,848评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,691评论 1 282
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,053评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,700评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 42,856评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,676评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,787评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,430评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,034评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,990评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,218评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,174评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,526评论 2 343

推荐阅读更多精彩内容