# 连接器请求与结果

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

这六个入口使用顶层路径和X-Workspace-ID。产品身份与运行期任务身份的正式边界分别由路由装配处理；示例使用普通PAT，不把任务证明当任意数据访问权限。

<span id="prepare"></span>

## 调用前准备

BASE_URL包含同环境产品前缀，MOI_KEY为产品凭据，WORKSPACE_ID为可访问工作区。请求中的connector_id来自已保存连接器；database、schema、table按上一次实际元数据结果填写。示例连接器和结果为固定占位值。

/db读取需要connector.use，服务还读取连接器配置并调用Worker；/mo目标读取另需export_task.create。没有分页或总数参数，不构造下一页链接。

<span id="responses"></span>

## 成功结果

成功使用字符串code=OK、msg=OK和data对象。databases/schemas/tables均为字符串数组；旧数据库/schema结果的nil切片可返回null，不把它当接口失败或全系统没有对象。表列表从transport对象投影名称，未保留全部原始定位信息。

| columns字段 | 类型 | 说明 |
| --- | --- | --- |
| `name` | string | 来源字段名。 |
| `data_type` | string | 来源类型。 |
| `mapped_type` | string | 映射类型。 |
| `is_primary_key` | boolean | 是否主键。 |
| `is_nullable` | boolean | 是否允许空值。 |
| `is_auto_incr` | boolean | 是否自增，false时HTTP可省略。 |

当前专用SDK保留这些字段的类型语义；重新编码JSON时默认false可能省略，不把缺失看成true。该结果不是现代schema_snapshot或目标字段兼容完整报告。

<span id="errors"></span>

## 错误及空结果

旧/db handler在部分参数或操作失败时仍写HTTP200和非OK业务code；SDK正常构造后还可能在响应解码阶段返回业务错误。必须同时检查HTTP、code和实际结果。身份/权限/依赖错误按各自映射，不宣称所有错误均HTTP200。

MatrixOne入口使用公共service错误适配，不复用旧/db固定错误状态。空结果仅表示该次当前权限/连接器/源目标的读取结果，不能代替来源连通、引擎兼容性或生产开放范围验证。
