v20200224

Documentation

Index

• Constants
• type Client
  • func NewClient(credential *common.Credential, region string, ...) (client *Client, err error)
  • func NewClientWithSecretId(secretId, secretKey, region string) (client *Client, err error)
  • func (c *Client) QueryLoginProtection(request *QueryLoginProtectionRequest) (response *QueryLoginProtectionResponse, err error)
• type QueryLoginProtectionRequest
  • func NewQueryLoginProtectionRequest() (request *QueryLoginProtectionRequest)
  • func (r *QueryLoginProtectionRequest) FromJsonString(s string) error
  • func (r *QueryLoginProtectionRequest) ToJsonString() string
• type QueryLoginProtectionResponse
  • func NewQueryLoginProtectionResponse() (response *QueryLoginProtectionResponse)
  • func (r *QueryLoginProtectionResponse) FromJsonString(s string) error
  • func (r *QueryLoginProtectionResponse) ToJsonString() string

Constants

const APIVersion = "2020-02-24"

Types

type Client

type Client struct {
	common.Client
}

func NewClient

func NewClient(credential *common.Credential, region string, clientProfile *profile.ClientProfile) (client *Client, err error)

func NewClientWithSecretId

func NewClientWithSecretId(secretId, secretKey, region string) (client *Client, err error)

Deprecated

func (*Client) QueryLoginProtection

func (c *Client) QueryLoginProtection(request *QueryLoginProtectionRequest) (response *QueryLoginProtectionResponse, err error)

登录保护服务（LoginProtection，LP）针对网站和 APP 的用户登录场景，实时检测是否存在盗号、撞库等恶意登录行为，帮助开发者发现异常登录，降低恶意用户登录给业务带来的风险。

type QueryLoginProtectionRequest

type QueryLoginProtectionRequest struct {
	*tchttp.BaseRequest

	// 登录来源的外网 IP。
	LoginIp *string `json:"LoginIp,omitempty" name:"LoginIp"`

	// 用户 ID 不同的 accountType 对应不同的用户 ID。如果是 QQ，则填入对应的 openid，微信用户则填入对应的 openid/unionid，手机号则填入对应真实用户手机号（如13123456789）。
	Uid *string `json:"Uid,omitempty" name:"Uid"`

	// 登录时间戳，单位：秒。
	LoginTime *string `json:"LoginTime,omitempty" name:"LoginTime"`

	// 用户账号类型（QQ 开放帐号、微信开放账号需要 提交工单 由腾讯云进行资格审核）：
	// 1：QQ 开放帐号。
	// 2：微信开放账号。
	// 4：手机号。
	// 0：其他。
	// 10004：手机号 MD5。
	AccountType *string `json:"AccountType,omitempty" name:"AccountType"`

	// accountType 是 QQ 或微信开放账号时，该参数必填，表示 QQ 或微信分配给网站或应用的 AppID，用来唯一标识网站或应用。
	AppIdU *string `json:"AppIdU,omitempty" name:"AppIdU"`

	// accountType 是 QQ 或微信开放账号时，用于标识 QQ 或微信用户登录后关联业务自身的账号 ID。
	AssociateAccount *string `json:"AssociateAccount,omitempty" name:"AssociateAccount"`

	// 昵称，UTF-8 编码。
	NickName *string `json:"NickName,omitempty" name:"NickName"`

	// 手机号：国家代码-手机号， 如0086-15912345687（0086前不需要+号）。
	PhoneNumber *string `json:"PhoneNumber,omitempty" name:"PhoneNumber"`

	// 用户邮箱地址（非系统自动生成）。
	EmailAddress *string `json:"EmailAddress,omitempty" name:"EmailAddress"`

	// 注册来源的外网 IP。
	RegisterTime *string `json:"RegisterTime,omitempty" name:"RegisterTime"`

	// 地址。
	Address *string `json:"Address,omitempty" name:"Address"`

	// 用户 HTTP 请求中的 cookie 进行2次 hash 的值，只要保证相同 cookie 的 hash 值一致即可。
	CookieHash *string `json:"CookieHash,omitempty" name:"CookieHash"`

	// 登录来源：
	// 0：其他
	// 1：PC 网页
	// 2：移动页面
	// 3：App
	// 4：微信公众号
	LoginSource *string `json:"LoginSource,omitempty" name:"LoginSource"`

	// 登录方式：
	// 0：其他
	// 1：手动帐号密码输入
	// 2：动态短信密码登录
	// 3：二维码扫描登录
	LoginType *string `json:"LoginType,omitempty" name:"LoginType"`

	// 用户 HTTP 请求的 referer 值。
	Referer *string `json:"Referer,omitempty" name:"Referer"`

	// 登录成功后跳转页面。
	JumpUrl *string `json:"JumpUrl,omitempty" name:"JumpUrl"`

	// 用户 HTTP 请求的 userAgent。
	UserAgent *string `json:"UserAgent,omitempty" name:"UserAgent"`

	// 用户 HTTP 请求中的 x_forward_for。
	XForwardedFor *string `json:"XForwardedFor,omitempty" name:"XForwardedFor"`

	// 用户操作过程中鼠标单击次数。
	MouseClickCount *string `json:"MouseClickCount,omitempty" name:"MouseClickCount"`

	// 用户操作过程中键盘单击次数。
	KeyboardClickCount *string `json:"KeyboardClickCount,omitempty" name:"KeyboardClickCount"`

	// 注册结果：
	// 0：失败
	// 1：成功
	Result *string `json:"Result,omitempty" name:"Result"`

	// 失败原因：
	// 0：其他
	// 1：参数错误
	// 2：帐号冲突
	// 3：验证错误
	Reason *string `json:"Reason,omitempty" name:"Reason"`

	// 登录耗时，单位：秒。
	LoginSpend *string `json:"LoginSpend,omitempty" name:"LoginSpend"`

	// MAC 地址或设备唯一标识。
	MacAddress *string `json:"MacAddress,omitempty" name:"MacAddress"`

	// 手机制造商 ID，如果手机注册，请带上此信息。
	VendorId *string `json:"VendorId,omitempty" name:"VendorId"`

	// App 客户端版本。
	AppVersion *string `json:"AppVersion,omitempty" name:"AppVersion"`

	// 手机设备号。
	Imei *string `json:"Imei,omitempty" name:"Imei"`

	// 业务 ID 网站或应用在多个业务中使用此服务，通过此 ID 区分统计数据。
	BusinessId *string `json:"BusinessId,omitempty" name:"BusinessId"`

	// 1：微信公众号
	// 2：微信小程序
	WxSubType *string `json:"WxSubType,omitempty" name:"WxSubType"`

	// Token 签名随机数，微信小程序必填，建议16个字符。
	RandNum *string `json:"RandNum,omitempty" name:"RandNum"`

	// 如果是微信小程序，该字段为以 ssesion_key 为 key 去签名随机数radnNum得到的值（hmac_sha256 签名算法）。
	// 如果是微信公众号或第三方登录，则为授权的 access_token（注意：不是普通 access_token，具体看 微信官方文档）。
	WxToken *string `json:"WxToken,omitempty" name:"WxToken"`
}

func NewQueryLoginProtectionRequest

func NewQueryLoginProtectionRequest() (request *QueryLoginProtectionRequest)

func (*QueryLoginProtectionRequest) FromJsonString

func (r *QueryLoginProtectionRequest) FromJsonString(s string) error

func (*QueryLoginProtectionRequest) ToJsonString

func (r *QueryLoginProtectionRequest) ToJsonString() string

type QueryLoginProtectionResponse

type QueryLoginProtectionResponse struct {
	*tchttp.BaseResponse
	Response *struct {

		// AssociateAccount
		//
		// accountType 是 QQ 或微信开放账号时，用于标识 QQ 或微信用户登录后关联业务自身的账号 ID。
		// LoginTime
		//
		// 操作时间。
		// Uid
		//
		// 用户 ID 不同的 accountType 对应不同的用户 ID。如果是 QQ，则填入对应的 openid，微信用户则填入对应的 openid/unionid，手机号则填入对应真实用户手机号（如13123456789）。
		// LoginIp
		//
		// 登录 IP。
		// Level
		//
		// 0：表示无恶意。
		// 1 - 4：恶意等级由低到高。
		// RiskType
		//
		// 风险类型。
		// 出参不用填"Req业务侧错误码。成功时返回 Success，错误时返回具体业务错误原因。uestId"等公共出参， 详细解释>>>
		// 注意：此字段可能返回 null，表示取不到有效值。
		CodeDesc *string `json:"CodeDesc,omitempty" name:"CodeDesc"`

		// accountType 是 QQ 或微信开放账号时，用于标识 QQ 或微信用户登录后关联业务自身的账号 ID。
		// 注意：此字段可能返回 null，表示取不到有效值。
		AssociateAccount *string `json:"AssociateAccount,omitempty" name:"AssociateAccount"`

		// 操作时间。
		// 注意：此字段可能返回 null，表示取不到有效值。
		LoginTime *string `json:"LoginTime,omitempty" name:"LoginTime"`

		// 用户 ID 不同的 accountType 对应不同的用户 ID。如果是 QQ，则填入对应的 openid，微信用户则填入对应的 openid/unionid，手机号则填入对应真实用户手机号（如13123456789）。
		// 注意：此字段可能返回 null，表示取不到有效值。
		Uid *string `json:"Uid,omitempty" name:"Uid"`

		// 登录 IP。
		// 注意：此字段可能返回 null，表示取不到有效值。
		LoginIp *string `json:"LoginIp,omitempty" name:"LoginIp"`

		// 0：表示无恶意。
		// 1 - 4：恶意等级由低到高。
		Level *int64 `json:"Level,omitempty" name:"Level"`

		// 风险类型。
		RiskType []*int64 `json:"RiskType,omitempty" name:"RiskType" list`

		// accountType 是 QQ 或微信开放账号时，用于标识 QQ 或微信用户登录后关联业务自身的账号 ID。
		// 注意：此字段可能返回 null，表示取不到有效值。
		RootId *string `json:"RootId,omitempty" name:"RootId"`

		// 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
		RequestId *string `json:"RequestId,omitempty" name:"RequestId"`
	} `json:"Response"`
}

func NewQueryLoginProtectionResponse

func NewQueryLoginProtectionResponse() (response *QueryLoginProtectionResponse)

func (*QueryLoginProtectionResponse) FromJsonString

func (r *QueryLoginProtectionResponse) FromJsonString(s string) error

func (*QueryLoginProtectionResponse) ToJsonString

func (r *QueryLoginProtectionResponse) ToJsonString() string