外呼撞库

域名：

• 测试环境：http://yrxd.test.creditease.cn
• 生产环境：http://www.yxh2.cn

---

签名：

请求接口需要签名验证,签名时，将所有参数按照参数名的字母顺序从小到大进行排序，然后将排序后的参数按照“参数名=参数值”的格式用“&”符拼接起来，并在最后拼接“&key=${key}”，最后进行签名计算。

注意：sign参数不参与签名，当参数为数组、列表、获取对象时，参与签名的参数值为使用fastjson序列化为JSON字符串。

盐key：线下给

例：

xxxxxxxxxxxxxxxxxxxxxxxxx

例：批量撞库接口签名

md5("userMd5List=["d64cb974110c8596ce6ade7754s1b9d6","4756b23f6790ebcd601b90dd6fba5cdc","b6s7ac29aea36d5e7ad69e07d0ff8b38"]&userMd5Type=0&utmSource=tf_ysst_gzh&key=xxxxxxxxxxxxxxxxxxxxxxxxx")

单次撞库接口

BASIC

Path: /api/collision/v1/advert/check/access

Method: POST

REQUEST

Headers:

name	value	required	desc
Content-Type	application/json	YES

Request Body:

name	type	必填	desc
phoneMd5	string	N	Md5 手机号
utmSource	string	Y	渠道名称 e.g. yrxd_web
sign	string	Y	签名
idNoMd5	string	N	身份证md5 暂不支持

Request Demo:

{
  "phoneMd5": "",
  "utmSource": "",
  "sign": "",
  "idNoMd5": ""
}

RESPONSE

Headers:

name	value	required	desc
content-type	application/json;charset=UTF-8	NO

Body:

name	type	必填	desc
status	string	Y	"0000" 成功，其他失败
msg	string	Y
data	object	Y
|─status	string	N	⽤户状态：0-未注册的⽤户 1-当前渠道已注册⽤户 2-其他渠道已注册⽤户 3-异常
|─userMd5	string	N	md5手机号或md5身份证号 普通撞库接口，该返回值与传入md5参数相同，优先md5手机号
|─marketable	integer	N	是否可营销 1.可营销 0.不可营销 status为0时才会有值

Response Demo:

{
  "status": "",
  "msg": "",
  "data": {
    "status": "",
    "userMd5": "",
    "marketable": 0
  }
}

---

批量撞库接口

BASIC

Path: /api/collision/v1/advert/check/access/batch

Method: POST

REQUEST

Headers:

name	value	required	desc
Content-Type	application/json	YES

Request Body:

name	type	必填	desc
userMd5List	array	Y	手机号Md5或身份证号Md5 最多1000条 userMd5Type为0传手机号Md5，为1传身份证号Md5
|─	string
userMd5Type	integer	Y	0-手机号Md5 1-身份证号Md5， 目前仅支持手机号撞库
utmSource	string	Y	渠道名称 e.g. yrxd_web
sign	string	Y	签名 e.g. 202cb962ac59075b2d234b70964b0715

Request Demo:

{
  "userMd5List": [
    ""
  ],
  "userMd5Type": 0,
  "utmSource": "",
  "sign": ""
}

RESPONSE

Headers:

name	value	required	desc
content-type	application/json;charset=UTF-8	NO

Body:

name	type	必填	desc
status	string	Y	"0000" 成功，其他失败
msg	string	Y
data	array	Y
|─	object
|─status	string	N	⽤户状态：0-未注册的⽤户 1-当前渠道已注册⽤户 2-其他渠道已注册⽤户 3-异常
|─userMd5	string	N	md5手机号或md5身份证号 普通撞库接口，该返回值与传入md5参数相同，优先md5手机号
|─marketable	integer	N	是否可营销 1.可营销 0.不可营销 status为0时才会有值

Response Demo:

{
  "status": "",
  "msg": "",
  "data": [
    {
      "status": "",
      "userMd5": "",
      "marketable": 0
    }
  ]
}

状态码status定义

状态码status	描述
0000	正常返回
9999	处理失败

注意：撞库结果status=0且marketable=1时，才可进行营销。