Skip to main content
GET
获取会话变量

授权

Authorization
string
header
必填

每个请求都通过 API Key 认证:Authorization: Bearer {API_KEY}。应用接口使用应用 API Key,知识库接口使用知识库 API Key(快速开始)。

API Key 应保存在服务端,切勿嵌入客户端代码。缺失或无效的 Key 会返回 HTTP 401(unauthorized)。

路径参数

conversation_id
string<uuid>
必填

要查询变量的会话 ID。会话 ID 可从 获取会话列表 获取。

查询参数

user
string
必填

终端用户标识,由你的应用定义,需在应用内唯一。会话同时归属于应用、环境和该 user,后续的读取和修改都要传入相同的值。参见 终端用户身份。

Required string length: 1 - 255
last_id
string<uuid>

分页游标:当前页最后一个变量的 id。省略则获取第一页。

limit
integer
默认值:20

返回的记录数。

必填范围: 1 <= x <= 100
variable_name
string

返回名称中包含该文本的变量,不区分大小写。

Required string length: 1 - 255

响应

该会话的一页变量,最早创建的排在前。

limit
integer

本页实际使用的分页大小。

has_more
boolean

是否还有下一页。

data
object[]

会话变量,按创建时间正序排列。