获取 IM 集成

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/admin/v1/integrations/8e6332af9d801f19496ca0f9fded5333' \
  -H 'Authorization: Bearer sk_xxxxxx'

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "agent_id": "9926a90400d85f0a54e9e195e915db44",
    "channel": "dingtalk",
    "created_at": 1760000000,
    "credentials_configured": false,
    "daily_message_limit": 1,
    "dataset_ids": [
      "3748f84ef0d2e877c0097b8f32d45cf0"
    ],
    "enabled": true,
    "external_app_id": "524832f3cb1ba8ef33208d0692b8d565",
    "id": "f58008acc066bab6dfb73de8efde8905",
    "name": "Example name",
    "read_only_project_ids": [
      "5af1515af082229ccfd68f981a6cf886"
    ],
    "read_write_project_id": "aed31b20113b86ecc2587aa0cbc0eb2f",
    "settings": {
      "card_template_id": "870213bad9d43369a8af134b1b482d6e"
    },
    "status": "pending",
    "updated_at": 1760000000,
    "workspace_id": "ce55865bcc4c12c26161d24b238a888e",
    "status_error": "example",
    "status_error_code": "credentials_invalid"
  }
}

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/admin/v1/integrations/8e6332af9d801f19496ca0f9fded5333' \
  -H 'Authorization: Bearer sk_xxxxxx'

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "agent_id": "9926a90400d85f0a54e9e195e915db44",
    "channel": "dingtalk",
    "created_at": 1760000000,
    "credentials_configured": false,
    "daily_message_limit": 1,
    "dataset_ids": [
      "3748f84ef0d2e877c0097b8f32d45cf0"
    ],
    "enabled": true,
    "external_app_id": "524832f3cb1ba8ef33208d0692b8d565",
    "id": "f58008acc066bab6dfb73de8efde8905",
    "name": "Example name",
    "read_only_project_ids": [
      "5af1515af082229ccfd68f981a6cf886"
    ],
    "read_write_project_id": "aed31b20113b86ecc2587aa0cbc0eb2f",
    "settings": {
      "card_template_id": "870213bad9d43369a8af134b1b482d6e"
    },
    "status": "pending",
    "updated_at": 1760000000,
    "workspace_id": "ce55865bcc4c12c26161d24b238a888e",
    "status_error": "example",
    "status_error_code": "credentials_invalid"
  }
}

GET /openapi/memorylake/admin/v1/integrations/{integration_id}

返回一个集成。创建或更改凭据后可轮询此接口，以跟踪 status（pending → connected 或 error）和 status_error。其他团队的集成会报告为未找到。

所需权限： workspace:integration_manage（作用于 workspace_id）

路径参数

string

必填

集成的标识符

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/admin/v1/integrations/8e6332af9d801f19496ca0f9fded5333' \
  -H 'Authorization: Bearer sk_xxxxxx'

响应

object

显示 Integration 对象

string

负责回复发送给该机器人的消息的 Agent

string

IM 平台。可选值：dingtalk、wecom、feishu、slack。

integer

创建时间，Unix 秒级时间戳

boolean

是否已存储凭据。凭据本身仅可写入，从不返回。

integer

此集成每天处理的最大消息数；0 表示不限

array

Agent 可使用的开放数据数据集

boolean

是否应连接该集成

string

机器人在 IM 平台上的标识符（DingTalk Client ID、Feishu App ID、WeCom Bot ID、Slack team:bot-user）。不属于机密信息。

string

集成的标识符

string

显示名称

array

额外检索的项目（只读）

string

从 IM 对话中提取的记忆写入的项目

object

渠道专属设置

显示 Integration Settings 对象

string

仅限 DingTalk：AI 卡片模板 ID。设置后回复将以流式写入交互卡片；省略或发送 "" 则以普通消息回复。

string

连接状态。创建后或更改凭据后为 pending，直至首次连接尝试；可轮询获取 IM 集成跟踪状态。可选值：pending、connected、error、disabled。

integer

最后更新时间，Unix 秒级时间戳

string

集成所属的工作空间。创建时确定。

string

status 为 error 时的简短规范化原因，用于展示（中文，采用控制台措辞，可能变化）。绝不包含平台的原始响应。程序中请使用 status_error_code。

string

稳定的原因代码，只要存在 status_error 就会返回。credentials_invalid：平台拒绝了凭据（请修正凭据）；subscribe_rejected：WeCom 拒绝了订阅——凭据错误或触发平台限流，会自动重试；preempted：另一个连接接管了该机器人，通常是同一机器人在另一环境中建立了连接；timeout / disconnected / connection_aborted / connection_failed：连接问题，会自动重试；dependency_unavailable：此部署依赖的某项服务不可用，会自动重试；dependency_misconfigured：此部署缺少该渠道所需的组件（WeCom 需要 Redis）——请联系运维人员；internal_error：我方故障；unknown：该原因记录于原因代码引入之前，会在下次连接尝试时被替换。今后可能新增代码；遇到无法识别的代码时，请按 connection_failed 处理。

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "agent_id": "9926a90400d85f0a54e9e195e915db44",
    "channel": "dingtalk",
    "created_at": 1760000000,
    "credentials_configured": false,
    "daily_message_limit": 1,
    "dataset_ids": [
      "3748f84ef0d2e877c0097b8f32d45cf0"
    ],
    "enabled": true,
    "external_app_id": "524832f3cb1ba8ef33208d0692b8d565",
    "id": "f58008acc066bab6dfb73de8efde8905",
    "name": "Example name",
    "read_only_project_ids": [
      "5af1515af082229ccfd68f981a6cf886"
    ],
    "read_write_project_id": "aed31b20113b86ecc2587aa0cbc0eb2f",
    "settings": {
      "card_template_id": "870213bad9d43369a8af134b1b482d6e"
    },
    "status": "pending",
    "updated_at": 1760000000,
    "workspace_id": "ce55865bcc4c12c26161d24b238a888e",
    "status_error": "example",
    "status_error_code": "credentials_invalid"
  }
}

错误

出错时返回 success: false、message 和 error_code。全部错误码见错误码。

状态码	含义
`401`	API Key 缺失、无效、已停用或已过期
`403`	该 Key 无权执行此操作
`404`	资源不存在
`422`	请求体或参数未通过校验
`429`	请求过多，请按 `Retry-After` 等待后重试
`500`	服务端错误

MemoryLake API

Memory Router API

路径参数

响应

错误

​路径参数

​响应

​错误

路径参数

响应

错误