API 概览

服务地址、协议约定、请求格式与通用响应

通过记忆库 API，你可以以编程方式写入记忆、检索记忆、管理画像模板。所有接口通过 DashScope 网关提供服务。

服务地址

https://dashscope.aliyuncs.com/api/v2/apps/memory/

所有接口使用统一的服务地址。将各接口页面列出的路径拼接到服务地址后即可得到完整请求地址，例如 /add 对应 https://dashscope.aliyuncs.com/api/v2/apps/memory/add。

协议约定

• 所有接口均通过 HTTPS 访问，不支持 HTTP
• 请求体和响应体均为 JSON 格式，字符集 UTF-8
• 写入和检索接口使用 POST 方法；列表查询使用 GET 方法；更新使用 PATCH；删除使用 DELETE

通用请求头

Header	必填	说明
Authorization	是	Bearer $DASHSCOPE_API_KEY，获取方式见鉴权
Content-Type	仅含请求体的接口必填	application/json

通用响应格式

成功响应的公共字段只有 request_id，其他业务字段因接口而异，请以对应接口页面为准。

成功响应：

{
  "request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

失败响应：

{
  "code": "InvalidParameter",
  "message": "user_id is required",
  "request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

排查问题时，请提供 request_id，以便技术支持快速定位。错误处理建议见错误码。

分页

列表接口支持分页查询：

参数	说明
page_size	每页数量
page_num	页码，从 1 开始