同步用户资料 - qianlongjinrong/Shoujidai-Yundaitong GitHub Wiki
- [接口说明]
该接口提供给合作机构做同步用户的工作、联系人、居住信息、婚姻、学历、信用卡、互联网信息至手机贷,便于计算用户授信额度和借贷成功的关键数据依据。该接口可单独同步某一类型的用户资料信息,也可一次性的将全部资料信息同步。
- [技术要求]
接口采用HTTP POST方式,数据组织采用JSON传递。
- [服务名称]
syncUserBaseInfo
- [请求业务数据报文-reqData参数说明]
参数名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
userCode | String(32) | 是 | 手机贷分配的用户编号。 有调用同步用户信息接口生成返回。 |
liveInfo | JSON | 否 | 用户居住信息 此节点的数据格式为JSON对象封装,具体参数明细请参考下面的 [请求业务数据报文- liveInfo参数说明] |
jobInfo | JSON | 否 | 工作信息 该信息为用户借贷关键资料,必须同步给手机贷。 此节点的数据格式为JSON对象封装,具体参数明细请参考下面的 [请求业务数据报文- jobInfo参数说明] |
contactInfo | JSON Array | 否 | 联系人信息 最多允许4位联系人,最少必须有一位联系人,并且第一位的联系人关系必须为父母或配偶。 该信息为用户借贷关键资料,必须同步给手机贷。 此节点的数据格式为JSON Array封装,具体参数明细请参考下面的 [请求业务数据报文- contactInfo参数说明] |
creditcardInfo | JSON Array | 否 | 信用卡信息 绑卡数不可超过2张。总绑卡数根据手机贷的限制来定,会有提示返回。 此节点的数据格式为JSON Array封装,具体参数明细请参考下面的 [请求业务数据报文- creditcardInfo参数说明] |
netInfo | JSON | 否 | 互联网信息 此节点的数据格式为JSON 对象封装,具体参数明细请参考下面的 [请求业务数据报文- netInfo参数说明] |
eduInfo | JSON | 否 | 用户学历信息。 此节点的数据格式为JSON对象封装,具体参数明细请参考下面的 [请求业务数据报文- eduInfo参数说明] |
personInfo | JSON | 否 | 用户个人信息,包含婚姻等。 此节点的数据格式为JSON对象封装,具体参数明细请参考下面的 [请求业务数据报文- personInfo参数说明] |
- [请求业务数据报文- liveInfo参数说明]
参数名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
tel | String(30) | 否 | 用户联系电话 包含固话、移动号码。 固话号码格式为:3-4位区号,7-8位固话号码,1-4位分机号-。其中区号和分机号非必须。 移动号码为:有效长度为11位,不要带国际区号+86。 |
province | String(50) | 是 | 居住地归属省份 参考国家统计局最新的行政区域码表中的定义。 例如北京市:110000 |
city | String(50) | 是 | 居住地归属市 参考国家统计局最新的行政区域码表中的定义。 例如北京市市辖区:110100 |
district | String(50) | 是 | 居住地归属区 参考国家统计局最新的行政区域码表中的定义。 例如北京市市辖区朝阳区:110105 |
address | String(100) | 是 | 居住地详细地址 例如:和平街街道111号 |
- [请求业务数据报文- jobInfo参数说明]
参数名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
jobEmail | String(30) | 否 | 工作邮箱 |
compName | String(60) | 是 | 公司名称 |
compTel | String(20) | 是 | 公司电话 包含固话、移动号码。 固话号码格式为:3-4位区号,7-8位固话号码,1-4位分机号-。其中区号和分机号非必须。 移动号码为:11位移动手机号,不包含国际区号+86。 |
office | String(50) | 是 | 公司职务 例如:项目经理 |
income | int(2) | 是 | 工资收入 0、2000以内 1、2000-3000 2、3000-5000 3、5000-8000 4、8000-12000 5、12000以上 |
jobType | int(2) | 是 | 职业类型 0、自由职业、 1、政府机关 2、学校 3、医院 4、企业公司 5、私营商铺 6、个体工商户 7、企业法人 8、网店卖家 |
province | String(50) | 否 | 公司所在省份 参考国家统计局最新的行政区域码表中的定义。 例如北京市:110000 |
city | String(50) | 否 | 公司所在市 参考国家统计局最新的行政区域码表中的定义。 例如北京市市辖区:110100 |
district | String(50) | 否 | 公司所在区 参考国家统计局最新的行政区域码表中的定义。 例如北京市市辖区朝阳区:110105 |
address | String(50) | 是 | 公司详细地址 |
- [请求业务数据报文- contactInfo参数说明]
注意:本节点数据为JSON数组格式的,多个联系人请以数组形式封装。
参数名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
seq | int(1) | 是 | 索引编码 从1开始以此类推,索引最大数为4。 |
linkman | int(1) | 是 | 联系人关系 至少有1个联系人、最多有4个联系人。第1个关系必须为父母或配偶,且必填。后3个关系任选。 0、 父母 1、 配偶 2、 兄弟姐妹 3、 亲属 4、 朋友 5、 同学 6、 同事 |
phone | String(11) | 是 | 联系人移动电话号码 有效长度为11位,不要带国际区号+86。 |
name | String(20) | 是 | 联系人名称 姓名中间不可出现特殊字符。 |
- [请求业务数据报文- creditcardInfo参数说明]
注意:本节点数据为JSON数组格式的,多个信用卡请以数组形式封装。
参数名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
creditcardNum | String(20) | 是 | 信用卡卡号 |
creditBankName | String(16) | 是 | 开户行银行名称 例如:中国银行 |
validityDate | String(12) | 否 | 信用卡有效期 例如:2017-06-20 |
amountLimit | String(20) | 否 | 信用卡额度 例如:50000 |
phoneNum | String(20) | 否 | 申预留手机号 有效长度为11位,不要带国际区号+86。 |
- [请求业务数据报文- netInfo参数说明]
参数名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
String(50) | 否 | QQ号码 | |
sina | String(50) | 否 | 新浪微博号 |
wchat | String(50) | 否 | 微信号 |
tencent | String(50) | 否 | 腾讯微博号 |
taobao | String(50) | 否 | 淘宝帐号 |
- [请求业务数据报文- eduInfo参数说明]
参数名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
education | int(2) | 是 | 用户教育学历 0、高中以下 1、高中 2、中专 3、大专 4、本科 5、硕士 6、博士 |
school | String(50) | 否 | 学校名称 中专及以下(0、1、2)可不填写学校名称 |
graduateDate | String(50) | 否 | 毕业年份 例如:2017 中专及以下(0、1、2)可不填写毕业年份 |
- [请求业务数据报文- personInfo参数说明]
参数名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
marrage | String(50) | 否 | 个人婚姻状况 0、未婚 1、已婚未育 2、已婚已育 3、离异 4、其他 |
- [响应业务数据报文说明]
该接口不返回业务报文数据,请根据公共响应报文体中的status=1则代表处理成功,如果status=0,则会返回具体错误原因的错误码和错误描述,data报文不出现。
- 【请求报文示例】
{
"userCode": "20170509223",
"liveInfo": {
"tel": "010-66886688",
"province": "110000",
"city": "110100",
"district": "110105",
"address": "和平街街道111号"
},
"jobInfo": {
"jobEmail": "[email protected]",
"compName": "上海科技公司",
"compTel": "010-88668866",
"office": "测试",
"income": 3,
"jobType": 4,
"province": "110000",
"city": "110100",
"district": "110105",
"address": "广渠门"
},
"contactInfo": [
{
"seq": 1,
"linkman": 0,
"name": "测试",
"phone": "13111111111"
},
{
"seq": 2,
"linkman": 4,
"name": "测试",
"phone": "13111111112"
},
{
"seq": 3,
"linkman": 6,
"name": "测试",
"phone": "13111111113"
},
{
"seq": 4,
"linkman": 3,
"name": "测试",
"phone": "13111111114"
}
],
"creditcardInfo": [
{
"creditcardNum": "6228480010939759717",
"creditBankName": "北京硅谷亮城支行",
"validityDate": "2017-06-20",
"amountLimit": "50000",
"phoneNum": "15101078414"
}
],
"netInfo": {
"qq": "111292057",
"sina": "121292057",
"wchat": "131292057",
"tencent": "141292057",
"taobao": "151292057"
},
"eduInfo": {
"education": 4,
"school": "北京大学",
"graduateDate": "2017"
},
"personInfo": {
"marrage": 1
}
}
- 【响应报文示例】
待补充
- [接口说明]
合作机构根据需要可以将用户的身份证明、学历证明、工作证明、收入证明、居住证明信息等同步至手机贷,对用户的授信及审批通过率会有一定的提升。
本接口的传输信息为资源图片,通过HTTP Request传上来 图片支持jpg和png格式,图片大小最大限制为500KB。
本接口为选调服务,不影响主流程。
- [技术要求]
接口采用HTTP POST方式,数据组织采用JSON传递。
- [服务名称]
uploadProveInfo
- [请求业务数据报文-reqData参数说明]
参数名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
userCode | String(32) | 是 | 手机贷分配的用户编号。 有调用同步用户信息接口生成返回。 |
type | int(1) | 是 | 图片类型 1、学历证明 2、工作证明 3、财力证明 4、身份证 5、住址图片 |
- [响应业务数据报文说明]
该接口不返回业务报文数据,请根据公共响应报文体中的status=1则代表处理成功,如果status=0,则会返回具体错误原因的错误码和错误描述,data报文不出现。
- 【请求报文示例】
{
"userCode": "2017062018923232892124",
"type": "1"
}
- 【响应报文示例】
{
}
- [接口说明]
合作机构将采集到的手持终端移动设备信息、通讯录信息、通话记录信息、短信信息等同步至手机贷,对用户的授信及审批通过率会有一定的提升。
本接口为选调服务,不影响主流程。
- [技术要求]
接口采用HTTP POST方式,数据组织采用JSON传递。
- [服务名称]
syncGatherInfo
- [请求业务数据报文-reqData参数说明]
参数名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
userCode | String(32) | 是 | 手机贷分配的用户编号。 有调用同步用户信息接口生成返回。 |
mobileInfo | JSON | 否 | 移动终端抓取信息节点 此节点的数据格式为JSON对象封装,具体参数明细请参考下面的[请求业务数据报文- mobileInfo参数说明] |
contactInfo | JSON Array | 否 | 采集的通讯录信息节点 此节点的数据格式为JSON Array对象封装,具体参数明细请参考下面的[请求业务数据报文- contactInfo参数说明] |
callInfo | JSON Array | 否 | 采集的通话记录信息节点 此节点的数据格式为JSON Array对象封装,具体参数明细请参考下面的[请求业务数据报文- callInfo参数说明] |
smsInfo | JSON Array | 否 | 采集的短信记录信息节点 此节点的数据格式为JSON Array对象封装,具体参数明细请参考下面的[请求业务数据报文- smsInfo参数说明] |
- [请求业务数据报文- mobileInfo参数说明]
参数名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
phone_name | String(64) | 是 | 手机名称 例如:我的Iphone |
photos | String(800) | 否 | 图片分类列表 数据格式为JSON Array 例如: [{"images" : 48}, {"Camera" : 28}, {"wallpaper" : 2}, {"base64" : 6}, {"img" : 4}] |
phone_number | String(18) | 否 | 采集到的手机移动号码 |
appNames | String(800) | 否 | App名称列表 IPHONE数据格式为JSON Array,例如: ["imeituan", "YY2", "Mogujie4iPhone", "BoxDrain", "MicroMessenger", "dntgAS", "掌阅听书"] 安卓数据格式为JSON对象,例如: { "19" : "com.tencent.karaoke", "17" : "com.tencent.mobileqq", "18" : "全民K歌", "15" : "com.shcc.microcredit", "16" : "QQ", "13" : "com.qiyi.video", "14" : "手机贷", "11" : "com.adobe.flashplayer" } |
phone_user_info | String(18) | 否 | 手机用户信息 例如:我的Iphone |
device_id | String(64) | 是 | 设备id |
qqNumbers | String(180) | 否 | QQ号列表 格式为简单JSON对象数组, 例如:["763213462", "3306304289"] |
phone_model | String(64) | 是 | 手机型号 例如:vivo Y23L |
networktype | String(18) | 否 | 网络类型 例如:2G |
phone_ip | String(18) | 否 | 手机号ip 例如:180.97.165.196 |
- [请求业务数据报文- contactInfo参数说明]
注意:本节点数据为JSON数组格式的,多个通讯录请以数组形式封装。
参数名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
tel | String(30) | 是 | 通讯录中的联系人手机号 |
name | String(18) | 是 | 通讯录中备注的联系人姓名 |
- [请求业务数据报文- callInfo参数说明]
注意:本节点数据为JSON数组格式的,通话记录列表请以数组形式封装。
参数名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
calltime | String(20) | 是 | 通话时间 例如:2016-06-22 14:41:42 |
type | int(1) | 是 | 呼叫类型 1、呼入 2、呼出 3、未接 4、挂断 |
phone | String(30) | 是 | 呼入或呼出的联系人手机号 |
duration | String(18) | 是 | 通话时长 单位:秒 例如:60 |
- [请求业务数据报文- smsInfo参数说明]
注意:本节点数据为JSON数组格式的,短信记录列表请以数组形式封装。
参数名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
calltime | String(20) | 否 | 短信发送或接受时间 例如:2016-06-22 14:41:42 |
type | int(1) | 否 | 类型 1、接受 2、发送 |
phone | int(1) | 否 | 接受者或者发送者的手机号 |
content | String(500) | 否 | 发送内容 |
- [响应业务数据报文说明]
该接口不返回业务报文数据,请根据公共响应报文体中的status=1则代表处理成功,如果status=0,则会返回具体错误原因的错误码和错误描述,data报文不出现。
- 【请求报文示例】
{
"userCode": "201703103",
"mobileInfo": {
"phone_name": "LeMobile",
"photos": [
{
"images": 48
},
{
"Camera": 28
},
{
"wallpaper": 2
}
],
"phone_number": "13761796536",
"appNames": [
"imeituan",
"YY2",
"Mogujie4iPhone",
"BoxDrain",
"MicroMessenger",
"dntgAS",
"掌阅听书"
],
"phone_user_info": "我的Iphone",
"device_id": "862381031918114",
"qqNumbers": [
"763213462",
"3306304289"
],
"phone_model": "LeX620",
"networktype": "4G",
"phone_ip": "101.230.198.106"
},
"contactInfo": [
{
"tel": "13818339026",
"name": "陆晟超"
},
{
"tel": "18101925367",
"name": "甘露"
},
{
"tel": "075584475709",
"name": "潘翔"
},
{
"tel": "15921592066",
"name": "高策"
}
],
"callInfo": [
{
"duration": "12",
"phone": "09516073696",
"calltime": "2016-09-0115: 55: 47",
"type": 2
},
{
"duration": "56",
"phone": "075527908137",
"calltime": "2016-09-0115: 56: 54",
"type": 2
},
{
"duration": "45",
"phone": "15122821486",
"calltime": "2016-09-0118: 08: 47",
"type": 2
},
{
"duration": "77",
"phone": "18801966400",
"calltime": "2016-09-0221: 54: 20",
"type": 2
}
],
"smsInfo": [
{
"calltime": "2016-06-22 14:41:4",
"type": "1",
"phone": "13111111112",
"content": "你好"
},
{
"calltime": "2016-02-22 14:41:4",
"type": "2",
"phone": "13211111112",
"content": "abc"
}
]
}
- 【响应报文示例】
待补充