2024.11.07 11:32:23

    接口说明

    用户数据人工审核的结果,客户可以通过轮询调用该接口获取结果数据。

    接口耗时

    提交接口的响应较快,正常100ms内返回结果,业务方根据需求适当调整超时时间,建议为1s

    请求

    请求地址

    名称
    HTTP URL https://openapi.dun.163.com/openapi/v2/audit/userCensor/callback
    HTTP Method GET

    请求头

    名称 类型 必填 描述
    X-YD-SECRETID String 商户密钥,请联系您的易盾策略经理配置,对应客户秘钥-AccessKey ID
    X-YD-TIMESTAMP String 请求当前 UNIX 时间戳,单位毫秒,请注意服务器时间是否同步
    X-YD-NONCE String 随机整数,与 timestamp 联合起来,用于防止重放攻击
    X-YD-SIGN String 采用sha1进行签名,验签内容: 请求的body请求串+ AccessSecretKey + timstamp + nonce 进行

    OPENAPI签名说明

    流程说明: 用户在访问易盾的 OpenAPI 时,都需要对发送到易盾的 HTTP 请求进行签名,以便于易盾能够识别发送请求的用户。需要使用访问密钥来对请求进行签名,访问密钥由易盾颁发的AccessKey ID和AccessKey Secret 组成,具体的签名步骤参见文档。

    签名获取说明

    对所有请求参数(包括所有私有参数) ,按照参数名ASCII码表升序顺序排序。如: foo=1, bar=2, foo_bar=3, baz=4排序后的顺序是bar=2, baz=4, foo=1, foobar=3。将排序好的参数名和参数值构造成字符串,格式为: key1+value1+key2+value2...。根据上面的示例得到的构造结果为: bar2baz4foo1foobar3。将上述构成的私有参数字符串后追加AccessSecretKey, Nonce, Timestamp,组成加密原始数据,结果为: bar2baz4foo1foobar3{AccessSecretKey)(Nonce){Timestamp)(大括号表示占位符,实际处理时请移除) 采用SHA1散列算法构成的原始数据进行加密返回。

    请求参数

    名称 类型 是否必填 最大长度 描述
    yidunRequestId String 64 幂等参数说明

    请求体示例

    https://openapi.dun.163.com/openapi/v2/audit/userCensor/callback?yidunRequestId=xxx

    响应

    该接口将返回请求t处理的结果状态

    响应结果

    响应字段的详细信息如下:

    名称 类型 必须返回 描述
    code Number 接口调用状态,200:正常,其他值:调用出错
    msg string 结果说明,如果接口调用出错,那么返回错误描述
    data Array 回调结果数组

    UserCensorResult

    名称 类型 必须返回 描述
    account Number Y 用户帐号
    censorLabels Array Y 标签信息

    UserCensorLabel

    名称 类型 必须返回 描述
    code String Y 标签id
    name String Y 标签名称
    customCode String 自定义标签id
    desc String 描述

    响应体示例

    {    
    	"code": 200,    
    	"msg": "成功",   
    	"data": [{            
    			"account": "UserId1",            
    			"censorLabels": [{                    
    				"code": "code1",                    
    				"name": "标签名称1",                    
    				"customCode": "xxxxx1",                    
    				"desc": "描述1"                
    			}, {                    
    				"code": "code2",                    
    				"name": "标签名称2",                    
    				"customCode": "xxxxx2",                    
    				"desc": "描述2"               
    				}            
    			]        
    		}   
    	] 
    }                
    Online Chat Tel:95163223 Free trial