Http API数据接入指南

支持实时API数据接入，API类型为回调型，即当发生变更时，直接回调CDP。通过此功能，客户可以实时获取数据变更的通知，便于及时处理数据变更。

• 用户需具备 项目中心-权限-按内容管理-模块-数据融合-新建数据连接 权限。
• 该功能仅SaaS支持。

新建数据连接，选择 HTTP API

• header：点击按钮自动生成，下方示例数据会实时同步header信息。

• URL地址：系统默认生成，用户可自行配置，填入希望接入的数据URL

• 输出数据类型：可选「数据集」或「元数据」

信息填写完成后，点击「测试连接」，成功后即可「保存」。

3.1 存储为数据集

输出数据类型选中「数据集」，会将api传入的实时数据存为数据集。

点击右上角「一键接入」，将自动创建prep建模流程，生成数据集。

3.2 存储为元数据

存储类型选中「元数据」，会在创建数据集基础上进行实时id-mapping，后自动在元数据管理中注册为实时数据源。
点击右上角「一键接入」，将弹窗进行实时id-mapping设置。可选 实时转换 或 实时生成。（可选的主体和ID类型需要先在ID图谱构建中完成配置）

• 实时转换：根据现有One-ID(即基准ID BaseID)实时查询，仅转换历史生成过one-id的部分。

• 实时生成：根据ID-Mapping统一服务，实时生成One-ID(即基准ID BaseID)，历史未生成过one-id的部分将重新生成one-id。

接入成功后，点击右上角「查看元数据」将跳转元数据管理页面，显示已经自动注册好的数据源。

Q1：Http Api 和Rest Api 有什么区别呢？

Http Api 是由平台侧提供上报接口，用户通过Http Api建立实时回传通道，平台侧接收用户行为事件数据上报进入CDP，最终数据会处理成行为数据格式（产物：实时数据源 - 行为元数据），Rest Api是由用户侧提供接口，平台侧来负责定期地离线同步数据。

Q2：Http Api 和流式数据源有什么区别呢？

流式数据库需要用户自有（私有化部署客户支持开源 Kafka 和 Pulsar，SaaS客户仅支持火山Kafka）。如果用户没有Kafka，则可选择Http Api。