# 解析结构化载入回填起点

解析结构化载入任务的回填起点。

```text
POST https://moi.matrixorigin.cn/newmoi/connectors/structured/v1/source/backfill-start/resolve
```

## 调用前准备

先确认结构化数据源和回填方式。准备个人访问令牌、工作区 ID 和连接器 ID。

## 请求体

| 参数 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- |
| `connector_id` | string | 是 | 连接器 ID。 |
| `source` | object | 是 | 结构化数据源，包含类型、数据库、Schema 和表信息。 |
| `watermark` | object | 否 | 用于解析回填起点的水位线配置。 |
| `start_mode` | string | 是 | 回填起点模式。 |
| `custom_start_value` | string | 否 | 自定义回填起点；适用时传递。 |

## 请求示例

```bash
curl -X POST "https://moi.matrixorigin.cn/newmoi/connectors/structured/v1/source/backfill-start/resolve" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d "{
    \"connector_id\": \"$CONNECTOR_ID\",
    \"source\": {\"connector_id\": \"$CONNECTOR_ID\", \"source_type\": \"SOURCE_TYPE_MYSQL\", \"database\": \"appdb\", \"schema\": \"public\", \"table\": \"orders\"},
    \"start_mode\": \"auto\"
  }"
```

## 成功响应

成功时返回可用于创建结构化载入任务的回填起点。

## 错误响应

数据源或回填模式无效时，检查连接器和 `source` 配置后重试。