用途:把任意 HTTP REST API 导入 PostHog 数据仓库,生成可查询的表。manifest 采用 RESTAPIConfig 结构,与 PostHog 内置 REST 连接器同形,由通用引擎处理认证、分页、JSONPath 记录提取和增量游标,无需为每个源写 Python。
主要能力:支持 bearer、api_key、http_basic、oauth2 认证;六种分页器;增量游标;父子扇出(仅一层嵌套);仅支持 GET 与 POST。
使用方式:先调用 external-data-sources-wizard 检查是否已有原生连接器,有则改用内置路径。然后收集 API 文档或端点描述,依据 manifest-reference.md 编写 manifest,用 external-data-sources-db-schema 校验并列出资源,用 external-data-sources-preview-resource 预览真实数据,确认 data_selector、primary_key、cursor_path 正确后,用 data-warehouse-source-setup 创建源,最后用 external-data-schemas-list 查看同步状态,并以 SELECT * FROM {prefix}_{resource_name} LIMIT 10 查询。
限制:alpha 能力,每个 manifest 最多 50 个资源,每个项目最多 5 个 Custom 源。密钥只能放在 auth_* 载荷键中,不得内联进 manifest,否则校验被拒。OAuth2 不支持交互式 authorization_code 流程;设置过程中须保持 client.auth 块一致并重复提交相同密钥。创建前务必预览,否则易产生零行或畸形行。