坏账治理结果推送
2024.08.14 14:50:31
坏账治理结果获取推送模式用于将坏账异步检测结果主动推送给客户,保证客户最快的获取结果。客户需要按照以下规范实现接收结果的接口。
接口说明
结果主动推送模式以数据为维度,将坏账异步检测结果推送给客户,需客户在调用检测接口时设置回调地址callbackUrl参数,客户方需保证回调接收接口的可用性和稳定性,确保能正常接收推送过来的结果数据
鉴权说明
易盾智能风控服务使用签名认证方法对接口进行鉴权,所有接口每一次请求都需要包含签名信息(signature 参数),以验证用户身份,防止信息被恶意篡改。目前支持MD5签名算法,详细信息请参见接口鉴权。
结果说明
- 协议说明:检测接口请求参数中指定了回调地址参数callbackUrl(即一个http(s)协议接口的URL)。主动推送接口需要支持http协议,支持POST方法,传输数据编码采用utf-8
- 接口性能:推送结果接口默认超时时间为2s,为了保证顺利接收数据,客户需保证接收接口可用性和性能稳定
- 幂等性:结果推送时同样的结果可能会多次请求客户接口。客户接口需要保证幂等性,能够正确处理重复结果数据
接口耗时
客户接收接口需保证接收接口可用性和性能稳定,易盾请求超时时间为2s,客户接口尽量保证在1s内返回应答
请求说明
请求地址
名称 | 值 |
---|---|
HTTP URL | 回调地址callbackUrl |
HTTP Method | POST |
请求头
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
Content-Type | String | 是 | 固定值:"application/x-www-form-urlencoded" |
请求参数
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
businessId | String | 是 | 每个业务接入时,会分配唯一的业务 ID。 |
secretId | String | 是 | 产品密钥,每个应用接入时,会分配secretId和私钥secretKey。 |
timestamp | Long | 是 | 接口调用时的UNIX时间戳,单位:毫秒,用于判断请求是否过期 |
nonce | String | 是 | 随机码,用于防止重放 |
signature | String | 是 | 请求签名,用来验证此次请求的合法性,具体算法见接口鉴权 |
callbackData | String | 是 | 主动推送结果数据,格式为json字符串 |
请求体实例
businessId=xxx&secretId=xxx×tamp=xxx&nonce=xxx&signature=xxx&callabckData=xxxx
callbackData为JSON字符串格式,请自行解析或者反序列化为JSON对象使用
坏账治理结果请求
callbackData详细字段信息如下:
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
taskId | String | 是 | 数据唯一标识 |
account | String | 是 | 用户账号 |
roleId | String | 否 | 角色ID |
server | String | 否 | 服务器 |
orderId | String | 是 | 订单ID |
risk | String | 是 | 风险结果: reject(异常),force_manual(可疑) |
tag | String | 是 | 风险标签 |
坏账治理结果请求示例
{
"taskId":"3pk5paj1z8xhb52emuzp2cdg00109v5f",
"account":"account001",
"roleId":"roleId001
"server":"server001",
"orderId":"orderId001",
"risk":"reject",
"tag":"tag001
}
响应
响应结果
客户接口接收到我们回调的结果后,需要返回应答信息,接口响应HTTP状态码为200;
目前推送方式默认连接超时(connect timeout)150ms,回调超时(socket timeout)为2s,建议收到推送检测结果后,优先返回reponse应答信息,异步处理检测结果,避免回调超时。
应答信息为json格式,字段定义如下:
参数 | 类型 | 描述 |
---|---|---|
code | Integer | 应答code,易盾方解析code为200表示推送成功 |
msg | String | 具体描述信息 |
响应结果示例
{
"code": 200,
"msg": "ok!"
}