文档首页/ 智果(AgentArts)智能体平台/ API参考/ API/ 沙箱工具/ 浏览器会话管理/ 查询浏览器会话详情 - ShowCoreBrowserSession
更新时间:2026-09-14 GMT+08:00
分享

查询浏览器会话详情 - ShowCoreBrowserSession

功能介绍

该API用于查询浏览器会话详情。

调用方法

请参见如何调用API。

授权信息

账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项。

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

agentarts:browser:showCoreBrowserSession

Read

browser *

g:ResourceTag/<tag-key>

-

-

URI

GET /v1/core/browser/{browser_id}/sessions/{session_id}

表1 路径参数

参数

是否必选

参数类型

描述

browser_id

是

String

参数解释:

浏览器ID,可通过查询浏览器列表接口获取。

约束限制:

必须为有效的UUID格式。

取值范围:

符合UUID正则^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$的36位字符串。

默认取值:

不涉及。

session_id

是

String

参数解释:

会话ID,可通过查询浏览器会话列表接口获取。

约束限制:

符合正则:^[a-zA-Z0-9_-]+$ , 长度1~128

取值范围:

不涉及。

默认取值:

不涉及。

请求参数

无

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

session_id

String

参数解释:

会话的ID。

取值范围:

符合正则:^[a-zA-Z0-9_-]+$, 长度1~128。

session_name

String

参数解释:

会话名称。

取值范围:

符合正则条件 ^[a-zA-Z0-9_-]+$,即仅允许字母、数字、中划线、下划线组成,字符长度 1-128。

status

String

参数解释:

会话状态。

取值范围:

  • RUNNING:运行中。

  • TERMINATING:终止中。

  • TERMINATED:已终止。

created_at

String

参数解释:

创建时间。

取值范围:

不涉及。

updated_at

String

参数解释:

上次更新时间。

取值范围:

ISO 8601格式日期时间字符串。

proxy_configuration

String

参数解释:

代理配置。

取值范围:

不涉及。

profile_id

String

参数解释:

关联配置文件ID。

取值范围:

不涉及。

状态码:400

表3 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。

error_msg

String

参数解释:

错误信息。

取值范围:

符合正则:^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()'"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

状态码:401

表4 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。

error_msg

String

参数解释:

错误信息。

取值范围:

符合正则:^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()'"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

状态码:403

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。

error_msg

String

参数解释:

错误信息。

取值范围:

符合正则:^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()'"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

encoded_authorization_message

String

参数解释:

编码后的授权失败信息。

取值范围:

长度1到4096个字符。

details

Array of CoreToolsCommonError objects

参数解释:

依赖的下游服务错误信息列表。

取值范围:

数组长度0到10个元素。

表6 CoreToolsCommonError

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。

error_msg

String

参数解释:

错误信息。

取值范围:

符合正则:^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()'"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

状态码:404

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。

error_msg

String

参数解释:

错误信息。

取值范围:

符合正则:^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()'"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

状态码:409

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。

error_msg

String

参数解释:

错误信息。

取值范围:

符合正则:^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()'"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

状态码:429

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。

error_msg

String

参数解释:

错误信息。

取值范围:

符合正则:^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()'"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

状态码:500

表10 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。

error_msg

String

参数解释:

错误信息。

取值范围:

符合正则:^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()'"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

请求示例

GET /v1/core/browser-session/9ca9f2a6-18e4-4777-b23b-8c21e978a1ad

响应示例

状态码:200

OK。

{
  "session_id" : "9ca9f2a6-18e4-4777-b23b-8c21e978a1ad",
  "session_name" : "vvvv",
  "status" : "RUNNING",
  "profile_id" : "7ca9f2a6-18e4-4b5c-a7d3-8c21e978a1ac",
  "created_at" : "2026-03-21T08:14:23.252+00:00",
  "updated_at" : "2026-03-21T09:12:25.139+00:00"
}

状态码:400

请求参数错误。

{
  "error_code" : "AgentArts.04000400",
  "error_msg" : "Invalid parameter."
}

状态码:401

认证失败。

{
  "error_code" : "AgentArts.04000401",
  "error_msg" : "Authentication failed: invalid token."
}

状态码:403

权限不足。

{
  "error_code" : "AgentArts.04000403",
  "error_msg" : "Authentication failed: you have no permission of XXX",
  "encoded_authorization_message" : "eyJlcnJvciI6ICJVbmF1dGhvcml6ZWQifQ==",
  "details" : [ {
    "error_code" : "AgentArts.04000403",
    "error_msg" : "Authentication failed."
  } ]
}

状态码:404

资源不存在。

{
  "error_code" : "AgentArts.04000404",
  "error_msg" : "resource xxx not exist"
}

状态码:409

操作冲突。

{
  "error_code" : "AgentArts.04000409",
  "error_msg" : "operation conflict"
}

状态码:429

请求频率超限。

{
  "error_code" : "AgentArts.04000429",
  "error_msg" : "The interface has been limited."
}

状态码:500

内部系统错误。

{
  "error_code" : "AgentArts.04000500",
  "error_msg" : "Internal error"
}

状态码

状态码

描述

200

OK。

400

请求参数错误。

401

认证失败。

403

权限不足。

404

资源不存在。

409

操作冲突。

429

请求频率超限。

500

内部系统错误。

错误码

请参见错误码。

相关文档