2024.11.07 11:32:23

    接口说明

    该接口支持客户自行提交待审用户相关信息至SAAS用户审核模块进行审核

    接口耗时

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

    请求

    请求地址

    名称
    HTTP URL https://openapi.dun.163.com/openapi/v2/audit/userCensor/submit
    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散列算法构成的原始数据进行加密返回。

    请求参数

    名称 类型 必填 最大长度 描述
    clientId String Y 64 客户ID,请联系您的易盾策略经理获取
    account String Y 128 用户唯一标识
    ruleId Number Y 10 用户审核打标规则的Id,需先在saas“用户审核管理”页面创建“用户打标”类型的规则
    profileUrl string N 2048 用户主页地址,用于传输这次数据的用户ID的后台地址,便于快速跳转
    phone string N 64 手机号,与易盾风险库匹配。默认国内手机号,如有海外手机,需包含国家地区代码,格式为“+447410xxx186(+44即为国家码)”。如果需要加密,支持传入hash值,hash算法:md5(phone)
    nickname String N 128 用户昵称,建议抄送,辅助机审策略精准调优
    gender Number N 4 用户性别,0未知,1男,2女,在社交、直播场景建议抄送,辅助策略精准调优
    age Number N 4 用户年龄,0未知,在社交场景建议抄送,辅助策略精准调优
    level Number N 4 用户等级,0未知,1初级,2中级,3高级,其他值请与易盾策略约定,建议抄送,辅助策略精准调优
    registerTime Number N 13 注册时间,UNIX 时间戳(毫秒值)
    friendNum Number N 20 好友数,在社交、直播场景中使用,建议抄送
    fansNum Number N 20 粉丝数,在社交、直播场景中使用,建议抄送
    isPremiumUse Number N 4 是否付费用户,0为默认值,1为付费,建议抄送,易盾将结合该信息综合判断
    role string N 32 用户类型角色,可针对不同的角色配置不同的策略。角色与易盾策略约定即可

    请求体示例

    https://openapi.dun.163.com/openapi/v2/audit/userCensor/submit?clientId=111&userAccount=222&ruleId=xxx

    响应

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

    响应结果

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

    名称 类型 必须返回 描述
    code Number 接口调用状态,200:正常,其他值:调用出错
    msg String 结果说明,如果接口调用出错,那么返回错误描述
    data Boolean true为数据处理成功,false为数据处理失败

    响应体示例

    { "code":200, "msg":"ok" "data":true }

    Online Chat Tel:95163223 Free trial