同步用户资料 - qianlongjinrong/Shoujidai-Yundaitong GitHub Wiki

1、同步用户关键资料接口

  • [接口说明]

该接口提供给合作机构做同步用户的工作、联系人、居住信息、婚姻、学历、信用卡、互联网信息至手机贷,便于计算用户授信额度和借贷成功的关键数据依据。该接口可单独同步某一类型的用户资料信息,也可一次性的将全部资料信息同步。

  • [技术要求]

接口采用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参数说明]
参数名称 类型 是否必填 说明
qq 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
    }
}
  • 【响应报文示例】
待补充

2、同步用户证明材料接口

  • [接口说明]

合作机构根据需要可以将用户的身份证明、学历证明、工作证明、收入证明、居住证明信息等同步至手机贷,对用户的授信及审批通过率会有一定的提升。

本接口的传输信息为资源图片,通过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"
}
  • 【响应报文示例】
{
}

3、同步用户认证采集信息

  • [接口说明]

合作机构将采集到的手持终端移动设备信息、通讯录信息、通话记录信息、短信信息等同步至手机贷,对用户的授信及审批通过率会有一定的提升。

本接口为选调服务,不影响主流程。

  • [技术要求]

接口采用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"
        }
    ]
}
  • 【响应报文示例】
待补充
⚠️ **GitHub.com Fallback** ⚠️