注册保护接口

最近更新时间:2019-07-24 11:34:02

接口描述

协议:HTTPS
域名:csec.api.qcloud.com
接口名:RegisterProtection

输入参数

注意:

以下所有参数在入参时,请正确传参,不能传入空值。

参数 是否必选 参数类型 参数描述
registerIp String 注册来源的外网 IP。
uid String 用户 ID 不同的 accountType 对应不同的用户 ID。如果是 QQ 或微信用户则填入对应的 OpenID。
registerTime UInt 注册时间戳,单位:秒。
accountType UInt 用户账号类型(QQ 开放帐号、微信开放账号需要 提交工单 由腾讯云进行资格审核):
  • 1:QQ 开放帐号。
  • 2:微信开放账号。
  • 4:手机号。
  • 0:其他。
  • 10004:手机号 MD5。
  • appId String accountType 是 QQ 或微信开放账号时,该参数必填,表示 QQ 或微信分配给给网站或应用的 AppID,用来唯一标识网站或应用。
    associateAccount String accountType 是 QQ 或微信开放账号时,用于标识 QQ 或微信用户登录后关联业务自身的账号 ID。
    nickName String 昵称,UTF-8 编码。
    phoneNumber String 手机号:国家代码-手机号, 如0086-15912345687(0086前不需要+号)。
    emailAddress String 用户邮箱地址(非系统自动生成)。
    address String 地址。
    cookieHash String 用户 HTTP 请求中的 cookie 进行2次 hash 的值,只要保证相同 cookie 的 hash 值一致即可。
    registerSource String 注册来源:
  • 0:其他。
  • 1:PC 网页。
  • 2:移动页面。
  • 3:App。
  • 4:微信公众号。
  • referer String 用户 HTTP 请求的 referer 值。
    jumpUrl String 注册成功后跳转页面。
    userAgent String 用户 HTTP 请求的 userAgent。
    xForwardedFor String 用户 HTTP 请求中的 x_forward_for。
    mouseClickCount Uint 用户操作过程中鼠标单击次数。
    keyboardClickCount Uint 用户操作过程中键盘单击次数。
    result Uint 注册结果:
  • 0:失败。
  • 1:成功。
  • reason Uint 失败原因:
  • 0:其他。
  • 1:参数错误。
  • 2:帐号冲突。
  • 3:验证错误。
  • registerSpend Uint 登录耗时,单位:秒。
    macAddress String MAC 地址或设备唯一标识。
    vendorId String 手机制造商 ID,如果手机注册,请带上此信息。
    appVersion String App 客户端版本。
    imei String 手机设备号。
    businessId Uint 业务 ID 网站或应用在多个业务中使用此服务,通过此 ID 区分统计数据。
    wxSubType Int
  • 1:微信公众号。
  • 2:微信小程序。
  • randNum String Token 签名随机数,微信小程序必填,建议16个字符。
    wxToken String
  • 如果是微信小程序,该字段为以 ssesion_key 为 key 去签名随机数 radnNum 得到的值(hmac_sha256签名算法)。
  • 如果是微信公众号或第三方登录,则为授权的 access_token(注意:不是普通 access_token,具体看 微信官方文档)。
  • 输出参数

    参数 类型 描述
    code Int 公共错误码:
  • 0:成功。
  • 其他值:失败。
  • 详情请参见错误码页面的 公共错误码
    codeDesc String 业务侧错误码,成功时返回 Success,错误时返回具体业务错误原因。
    message String 模块错误信息描述,与接口相关。
    Nonce UInt 随机正整数,与 Timestamp 联合起来, 用于防止重放攻击(公共参数)。
    associateAccount String accountType 是 QQ 或微信开放账号时,用于标识 QQ 或微信用户登录后关联业务自身的账号 ID。
    registerTime String 注册时间戳,单位:秒。
    uid String 用户 ID accountType 不同对应不同的用户 ID。如是 QQ 或微信用户则填入对应的 OpenID。
    registerIp String 注册来源的外网 IP。
    level Int
  • 0:表示无恶意。
  • 1 - 4:恶意等级由低到高。
  • riskType Array 风险类型,详情请参见下文 riskType 详细说明

    riskType 详细说明

    风险类型风险详情风险码说明
    账号风险 账号信用低1账号近期存在因恶意被处罚历史,网络低活跃,被举报等因素。
    垃圾账号2疑似批量注册小号,近期存在严重违规或大量举报。
    无效账号3送检账号参数无法成功解析,请检查微信 OpenID 是否有误 。
    黑名单4该账号在业务侧有过拉黑记录。
    白名单5业务自行有添加过白名单记录。
    行为风险批量操作101存在 IP/设备/环境等因素的聚集性异常。
    自动机102疑似自动机批量请求。
    微信登录态无效104检查 wxtoken 参数,是否已经失效。
    环境风险环境异常201操作 IP/设备/环境存在异常。当前 IP 为非常用 IP 或恶意 IP 段。
    JS 上报异常202需要用户在前端部署 JS 方有效。
    撞库203该账号有过“撞库”的历史行为。
    非公网有效 IP205传进来的 IP 地址为内网 IP 地址或者 IP 保留地址 。

    示例代码

    一个完整的请求需要两类请求参数:公共请求参数和接口请求参数。本文只列出了接口请求参数,并未列出公共请求参数,有关公共请求参数的更多说明,请参见 公共请求参数。公共参数传参中不需要添加 SignatureMethod 参数,签名计算默认使用 HmacSHA1 的签名算法,示例代码中有具体实现。

    • 请求示例
      <https://csec.api.qcloud.com/v2/index.php?Action=RegisterProtection
      &<公共请求参数>
      &secretId=AKIDmQtAxYTAB2iBS8s2DCzazCD2g7OUq4Zw
      &accountType=1
      &uid=D692D87319F2098C3877C3904B304706
      &registerIp=127.0.0.1(调用时必须是外网有效ip地址)
      &registerTime=1553484280(uinx时间戳,仅需要精确到秒)
      &associateAccount="SpFsjpyvaJ27329"
    • 响应示例
      {
        "Nonce": 516529719,
        "associateAccount": "SpFsjpyvaJ27329",
        "code": 0,
        "level ": 1,
        "message": "NoError",
        "registerTime": "1553484280",
        "rootId": "sdsds234sd",
        "uid": "D692D87319F2098C3877C3904B304706",
        "registerIp": "127.0.0.1",
        "riskType": [1]
      }
    • 代码下载