文档中心

概述

登录保护API是基于业务场景，结合IP画像、设备指纹、黑卡检测、威胁情报等多维度信息实时识别风险的专业防护产品，有效识别和解决垃圾账号注册、账号隐私泄漏、暴力破解、拖库撞库、漏洞注入等安全隐患。

如果您是初次调用百度智能云产品的API，可以观看API入门视频指南，快速掌握调用API的方法。

接口规范

URL

认证机制

所有API的安全认证一律采用Access Key与请求签名机制。 Access Key由Access Key ID和Secret Access Key组成，均为字符串。 对于每个HTTP请求，使用下面所描述的算法生成一个认证字符串。提交认证字符串放在Authorization头域里。服务端根据生成算法验证认证字符串的正确性。 认证字符串的格式为：
bce-auth-v{version}/{accessKeyId}/{timestamp}/{expirationPeriodInSeconds}/{signedHeaders}/{signature}

• version是正整数。
• timestamp是生成签名时的UTC时间。
• expirationPeriodInSeconds表示签名有效期限。
• signedHeaders是签名算法中涉及到的头域列表。头域名之间用分号（;）分隔，如host;x-bce-date。列表按照字典序排列。（本API签名仅使用host和x-bce-date两个header）
• signature是256位签名的十六进制表示，由64个小写字母组成。

当百度智能云接收到用户的请求后，系统将使用相同的SK和同样的认证机制生成认证字符串，并与用户请求中包含的认证字符串进行比对。如果认证字符串相同，系统认为用户拥有指定的操作权限，并执行相关操作；如果认证字符串不同，系统将忽略该操作并返回错误码。

鉴权认证机制的详细内容请参见鉴权认证机制。

入参（JSON格式）

接入参数举例

{ 
      "sc":"account_login",
      "ts": "1584871823371",
      "m": "3fae11dea7c6543266d1ce4183d7826e2d494afb",
      "ip": "125.124.234.121",
      "userid":"1111111",
      "username":"小快乐",
      "email":"www@xxx.com",
      "app":"android",
      "appid":"1",
      "aid":"9999",
      "z":"at8TermQ1qVdEokgqxb1LpiGdDDIHv258FKGKh9U3liFHWQhyC_1NsXRYV6avhaUjvaAWmYs4agXcnG1T8jvMuA",
      "i": "863811016480000",
      "imsi": 460023192787105,
      "logintype":"sms",
      "loginacctype": "mobile",
      "userId": "111111",
      "ver":"11.10.2",
      "ssid":"JXU2MjExJXU1QkI2JXU3Njg0d2lmaQ==",
      "bssid":"RkYlM0FGRiUzQUZGJTNBRkYlM0FGRiUzQUZG",
      "model":"SM-A8050",
      "ua":"Dalvik/2.1.0 (Linux; U; Android 9; Redmi Note 8 Pro MIUI/V10.4.6.0.PGGCNXM)",
      "mac": "34:17:EB:CE:A3:86",
      "net": "4G",
      "to": "20$504815761154628458843653317415879759920155241dd15bbfd3b9970455

e194d8134bd74885e443328ee707dcf832203015811ceeae1c1a9421576115466546",
      "vw": "021170450480000000000000000000000000000000000000000000008

401ff8003757CA66B1FC32998AFFCCDD68DBACC4B2:FG=10000000000000"
    }

响应结果

正常返回结果（正常返回结果是一个json）

正常返回示例：

{
    "request_id": "f88150bf-9da1-41fc-a740-b896be20cc31",
    "ret_code": "0",
    "ret_data": {
        "level": "1",
        "t": [
            "XXXX"
        ]
    },
    "ret_msg": "操作成功"
}

异常返回结果

异常返回示例：

{ 
    "request_id":"4017678614",
    "ret_code":"1001",
    "ret_msg":"认证失败"
}

SDK调用指南

• Java-SDK入门指南
• PHP-SDK入门指南
• Python-SDK入门指南