查询连接详情¶

接口用途¶

查看连接详情。

请求方式¶

GET

接口地址¶

https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/connections/<connection_id>

身份认证¶

使用工作区 API Key，在请求头中携带 X-API-Key: <WORKSPACE_API_KEY>，并设置 Content-Type: application/json。

路径参数¶

名称	说明
`connection_id`	连接标识。

查询参数¶

无。

请求体¶

无请求体。

请求示例¶

curl -X GET 'https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/connections/<connection_id>' \
  -H 'X-API-Key: <WORKSPACE_API_KEY>' \
  -H 'Content-Type: application/json'

响应说明¶

除 A2A JSON-RPC 外，多数工作区接口成功响应形如 {"code":0,"data":...}；下列字段描述 data（或 HTTP 202 时的 data）。

连接详情：

字段	类型	说明
`id`	string	连接 ID
`workspace_id`	string	工作区 ID
`name`	string	连接名称
`description`	string	描述
`status`	string	状态
`kind`	string	连接类型（如 MCP）
`endpoint_uri`	string	远端 endpoint
`auth_type`	string	如 `none` / `bearer_token` / `api_key` / `basic`
`credential_ref`	string	凭据引用；文档中勿展开明文
`capabilities`	array	能力列表
`visibility`	string	可见性
`config`	object	连接配置
`version`	integer	版本
`created_at`	string	创建时间
`updated_at`	string	更新时间

不应在文档里展开 credential 明文。

使用限制¶

响应若包含敏感字段，展示与存储时需脱敏。