2025.06.25 13:50:48

    接口说明

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

    接口耗时

    提交接口的响应较快,正常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 用户帐号
    ruleId Number 审核规则 id
    censorLabels Array 标签信息

    UserCensorLabel

    名称 类型 必须返回 描述
    code String 标签id
    name String 标签名称
    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"               
    				}            
    			]        
    		}   
    	] 
    }                
    在线咨询 电话咨询:95163223 免费试用