如何通过API获取Airbyte Sources的sourceDefinitionId？是否必填？

1. sourceDefinitionId 是否为必填项 #

调用 /api/v1/sources/create 接口时，sourceDefinitionId 是必填字段。它用于指定你要创建的数据源对应的预定义类型（比如你使用的 facebook-marketing），Airbyte 需要通过这个 ID 识别并初始化对应的数据源实例，缺少该字段会导致接口请求失败。

2. 正确获取 sourceDefinitionId 的方法 #

有两种可靠途径获取目标数据源的 sourceDefinitionId：

• 通过 Airbyte API 查询：发送 GET 请求到 /api/v1/source_definitions/list 接口，无需请求体。返回的响应中会包含所有 Airbyte 支持的数据源定义列表，找到你需要的类型（如 Facebook Marketing），提取对应的 sourceDefinitionId 值即可。
  响应示例片段：

  {
    "sourceDefinitions": [
      {
        "sourceDefinitionId": "252d591d-60ed-42e5-8c6b-0bf0232d2530",
        "name": "Facebook Marketing",
        "dockerRepository": "airbyte/source-facebook-marketing",
        "dockerImageTag": "0.2.35"
      }
    ]
  }
  

• 通过 Airbyte UI 界面提取：登录 Airbyte 后台，进入「创建数据源」页面，选择目标数据源类型（如 Facebook Marketing）。打开浏览器开发者工具的「网络」面板，查找页面加载过程中涉及的请求，在请求参数或响应内容中找到 sourceDefinitionId 并复制。

3. 你的请求体优化建议 #

你当前请求体的 configuration 字段中包含的 sourceType 是冗余字段，因为 sourceDefinitionId 已经明确了数据源类型，保留该字段可能引发接口异常。建议移除后调整请求体如下：

{
  "sourceDefinitionId": "获取到的正确ID",
  "workspace_id": "my ID",
  "configuration": {
    "account_ids": ["my account ID"],
    "access_token": "my token"
  }
}

内容的提问来源于stack exchange，提问作者Felix Platzer