{
  "name": "tds",
  "display_name": "设备安全",
  "description": "腾讯设备安全服务接口，供企业及用户集成调用，设备安全产品基于实时风险模型、信誉库，通过对可信设备标识多纬度分析，有效识别业务方在业务过程中的欺诈风险，基于接口返回风险标签，联动业务系统进行安全处理。",
  "domain": "other",
  "api_version": "2022-08-01",
  "endpoint": "tds.tencentcloudapi.com",
  "actions": [
    {
      "name": "DescribeFinanceFraudUltimate",
      "description": "查询设备标识及风险（金融旗舰版）",
      "status": "online",
      "parameters": [
        {
          "name": "DeviceToken",
          "type": "string",
          "required": true,
          "description": "客户端通过SDK获取的设备Token",
          "example": "eHh4eHh4eHg="
        },
        {
          "name": "SceneCode",
          "type": "string",
          "required": true,
          "description": "使用场景。目前仅支持login-登录场景、register-注册场景",
          "example": "login"
        },
        {
          "name": "UserId",
          "type": "string",
          "required": true,
          "description": "用户唯一标识",
          "example": "15000000000"
        },
        {
          "name": "EventTime",
          "type": "integer",
          "required": true,
          "description": "事件时间戳（毫秒）",
          "example": "1666684836384"
        },
        {
          "name": "ElapsedTime",
          "type": "integer",
          "required": false,
          "description": "事件耗时（毫秒），例如进入登录界面到点击登录按钮耗时",
          "example": "1"
        },
        {
          "name": "WeChatOpenId",
          "type": "string",
          "required": false,
          "description": "微信的OpenId",
          "example": "oOn8tchm7************0vlzm"
        },
        {
          "name": "PhoneNumber",
          "type": "string",
          "required": false,
          "description": "手机号码（注：不需要带国家代码 例如：13430421011）。可以传入原文或MD5",
          "example": "15000000000"
        },
        {
          "name": "BizClientIp",
          "type": "string",
          "required": false,
          "description": "业务客户端IP",
          "example": "183.60.88.11"
        },
        {
          "name": "QQOpenId",
          "type": "string",
          "required": false,
          "description": "QQ的OpenId",
          "example": "A8E0232CD************2058B0EA885"
        },
        {
          "name": "DataAuthorization",
          "type": "object",
          "required": false,
          "description": "数据授权信息",
          "example": "无",
          "children": [
            {
              "name": "DataProviderName",
              "type": "string",
              "required": true,
              "description": "数据委托方、需求方：客户主体名称。",
              "example": "某某有限公司"
            },
            {
              "name": "DataRecipientName",
              "type": "string",
              "required": true,
              "description": "数据受托方、提供方：腾讯云主体名称。 固定填：腾讯云计算（北京）有限责任公司",
              "example": "腾讯云计算（北京）有限责任公司"
            },
            {
              "name": "UserDataType",
              "type": "array",
              "required": true,
              "description": "客户请求所涉及的用户个人信息类型，支持多选。实际以接口请求传参为准。 1-手机号； 2-微信开放账号； 3-QQ开放账号； 4-IP地址；",
              "example": "[1, 4]",
              "item_type": "integer"
            },
            {
              "name": "IsAuthorize",
              "type": "integer",
              "required": true,
              "description": "客户是否已按合规指南要求获取用户授权，同意客户委托腾讯云处理入参信息，结合已合法收集的用户数据进行必要处理得出服务结果，并返回给客户。 1-已授权；其它值为未授权。",
              "example": "1"
            },
            {
              "name": "AuthorizationTerm",
              "type": "integer",
              "required": false,
              "description": "客户获得的用户授权期限时间戳（单位秒）。 不填或0默认无固定期限。",
              "example": "1719805604"
            },
            {
              "name": "PrivacyPolicyLink",
              "type": "string",
              "required": false,
              "description": "客户获得用户授权所依赖的协议地址。",
              "example": "https://www.*****.com/*****"
            }
          ]
        }
      ],
      "required": [
        "DeviceToken",
        "SceneCode",
        "UserId",
        "EventTime"
      ]
    },
    {
      "name": "DescribeFraudBase",
      "description": "查询设备风险",
      "status": "online",
      "parameters": [
        {
          "name": "DeviceToken",
          "type": "string",
          "required": true,
          "description": "客户端通过SDK获取的设备Token",
          "example": "eHh4eHh4eHg="
        }
      ],
      "required": [
        "DeviceToken"
      ]
    },
    {
      "name": "DescribeFraudPremium",
      "description": "查询设备标识及风险",
      "status": "online",
      "parameters": [
        {
          "name": "DeviceToken",
          "type": "string",
          "required": true,
          "description": "客户端通过SDK获取的设备Token",
          "example": "eHh4eHh4eHg="
        }
      ],
      "required": [
        "DeviceToken"
      ]
    },
    {
      "name": "DescribeFraudUltimate",
      "description": "查询设备标识及风险（旗舰版）",
      "status": "online",
      "parameters": [
        {
          "name": "DeviceToken",
          "type": "string",
          "required": true,
          "description": "客户端通过SDK获取的设备Token",
          "example": "eHh4eHh4eHg="
        },
        {
          "name": "SceneCode",
          "type": "string",
          "required": true,
          "description": "使用场景。目前仅支持login-登录场景、register-注册场景",
          "example": "login"
        },
        {
          "name": "UserId",
          "type": "string",
          "required": true,
          "description": "用户唯一标识",
          "example": "15000000000"
        },
        {
          "name": "EventTime",
          "type": "integer",
          "required": true,
          "description": "事件时间戳（毫秒）",
          "example": "1666684836384"
        },
        {
          "name": "ElapsedTime",
          "type": "integer",
          "required": false,
          "description": "事件耗时（毫秒），例如进入登录界面到点击登录按钮耗时",
          "example": "1"
        },
        {
          "name": "WeChatOpenId",
          "type": "string",
          "required": false,
          "description": "微信的OpenId",
          "example": "oOn8tchm7************0vlzm"
        },
        {
          "name": "PhoneNumber",
          "type": "string",
          "required": false,
          "description": "手机号码（注：不需要带国家代码 例如：13430421011）。可以传入原文或MD5",
          "example": "15000000000"
        },
        {
          "name": "ClientIP",
          "type": "string",
          "required": false,
          "description": "客户端IP",
          "example": "183.60.88.11"
        },
        {
          "name": "QQOpenId",
          "type": "string",
          "required": false,
          "description": "QQ的OpenId",
          "example": "A8E0232CD************2058B0EA885"
        },
        {
          "name": "DataAuthorization",
          "type": "object",
          "required": false,
          "description": "数据授权信息",
          "example": "无",
          "children": [
            {
              "name": "DataProviderName",
              "type": "string",
              "required": true,
              "description": "数据委托方、需求方：客户主体名称。",
              "example": "某某有限公司"
            },
            {
              "name": "DataRecipientName",
              "type": "string",
              "required": true,
              "description": "数据受托方、提供方：腾讯云主体名称。 固定填：腾讯云计算（北京）有限责任公司",
              "example": "腾讯云计算（北京）有限责任公司"
            },
            {
              "name": "UserDataType",
              "type": "array",
              "required": true,
              "description": "客户请求所涉及的用户个人信息类型，支持多选。实际以接口请求传参为准。 1-手机号； 2-微信开放账号； 3-QQ开放账号； 4-IP地址；",
              "example": "[1, 4]",
              "item_type": "integer"
            },
            {
              "name": "IsAuthorize",
              "type": "integer",
              "required": true,
              "description": "客户是否已按合规指南要求获取用户授权，同意客户委托腾讯云处理入参信息，结合已合法收集的用户数据进行必要处理得出服务结果，并返回给客户。 1-已授权；其它值为未授权。",
              "example": "1"
            },
            {
              "name": "AuthorizationTerm",
              "type": "integer",
              "required": false,
              "description": "客户获得的用户授权期限时间戳（单位秒）。 不填或0默认无固定期限。",
              "example": "1719805604"
            },
            {
              "name": "PrivacyPolicyLink",
              "type": "string",
              "required": false,
              "description": "客户获得用户授权所依赖的协议地址。",
              "example": "https://www.*****.com/*****"
            }
          ]
        }
      ],
      "required": [
        "DeviceToken",
        "SceneCode",
        "UserId",
        "EventTime"
      ]
    },
    {
      "name": "DescribeTrustedID",
      "description": "查询设备标识",
      "status": "online",
      "parameters": [
        {
          "name": "DeviceToken",
          "type": "string",
          "required": true,
          "description": "客户端通过SDK获取的设备Token",
          "example": "eHh4eHh4eHg="
        }
      ],
      "required": [
        "DeviceToken"
      ]
    }
  ]
}