调用 DescribeListSessions 接口,用户获取登录态列表信息。

调用 DescribeListSessions 接口,用户可以获取已创建的登录态信息,进行管理或者编辑。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeListSessions

系统规定参数。取值:DescribeListSessions。

Asset String foo.com

资产名称。查询指定资产的登录态信息

CurrentPage Integer 1

指定返回结果的当前页码。默认值为1。

PageSize Integer 10

指定列表每页显示数据条数。默认值为10,且可设置值最大为10。

返回数据

名称 类型 示例值 描述
CurrentPage Integer 1

指定返回结果的当前页码。默认值为1。

PageSize Integer 10

指定列表每页显示数据条数。默认值为10,且可设置值最大为10。

RequestId String 9D2C9710-A52C-4C4A-9082-9E570C958D5D

返回结果的请求ID。

Sessions

Session 登录态信息

AliUid Integer 1234567

用户 AliUid

Asset String foo.com

资产名称。查询指定资产下的检测数据。

CreatedAt Long 1561392000000

创建时间戳。登录态创建的时间。

Expired Integer 0

登录态是否过期。0 未过期,1 过期。

LoginSession String Cookie: gr_user_id=b7c48e18-1b4b-4c55-9281-b961a1022d40;

登录态 Cookie 信息。目前只支持 Cookie 格式,添加的时候需要加上 "Cookie: " 前缀。

ModifiedAt Long 1561392000000

登录态最新修改时间戳。用户修改登录态的最新时间。

SessionId Integer 1

登录态 SessionID

TTL Integer 3600

登录态过期时间。用户可以设定此过期时间来判断登录态是否过期。

TotalCount Integer 100

返回数据的总数量。

示例

请求示例


http(s)://[Endpoint]/?Action=DescribeListSessions
&<公共请求参数>

正常返回示例

XML 格式

<code>200</code>
<success>true</success>
<requestId>9D2C9710-A52C-4C4A-9082-9E570C958D5D</requestId>
<data>
    <TotalCount>120</TotalCount>
    <Sessions>
        <Expired>0</Expired>
        <LoginSession>Cookie: gr_user_id=b7c48e18-1b4b-4c55-9281-b961a1022d40</LoginSession>
        <CreatedAt>1561392000000</CreatedAt>
        <AliUid>1234567789</AliUid>
        <SessionId>48</SessionId>
        <Asset>www.foo.cn</Asset>
        <ModifiedAt>1561392000000</ModifiedAt>
        <TTL>3600</TTL>
    </Sessions>
    <Sessions>
        <Expired>0</Expired>
        <LoginSession>Cookie: gr_user_id=b7c48e18-1b4b-4c55-9281-b961a1022d40</LoginSession>
        <CreatedAt>1561392000010</CreatedAt>
        <AliUid>1234567789</AliUid>
        <SessionId>30</SessionId>
        <Asset>www.bar.com</Asset>
        <ModifiedAt>1561392000000</ModifiedAt>
        <TTL>10</TTL>
    </Sessions>
</data>

JSON 格式

{
	"requestId":"9D2C9710-A52C-4C4A-9082-9E570C958D5D",
	"data":{
		"Sessions":[
			{
				"SessionId":48,
				"ModifiedAt":1561392000000,
				"AliUid":"1234567789",
				"Expired":0,
				"Asset":"www.foo.cn",
				"LoginSession":"Cookie: gr_user_id=b7c48e18-1b4b-4c55-9281-b961a1022d40",
				"TTL":3600,
				"CreatedAt":1561392000000
			},
			{
				"SessionId":30,
				"ModifiedAt":1561392000000,
				"AliUid":"1234567789",
				"Expired":0,
				"Asset":"www.bar.com",
				"LoginSession":"Cookie: gr_user_id=b7c48e18-1b4b-4c55-9281-b961a1022d40",
				"TTL":10,
				"CreatedAt":1561392000010
			}
		],
		"TotalCount":120
	},
	"code":"200",
	"success":true
}

错误码

访问错误中心查看更多错误码。