SuperAPI AI 工具集

segment

编程与开发

查看项目

更新于 10-16 09:47

技能介绍

用途:通过 Segment Public API 查询客户数据平台(CDP)的工作区配置,覆盖 Sources、Destinations、仓库、Tracking Plans 与投递指标等资源,便于排查数据管道与追踪配置问题。

主要能力:列出与获取 Sources、列出某 Source 已连接的 Destinations、列出与获取 Destinations、查看 Destination 投递指标、列出与获取 Tracking Plans 及其规则。

使用方式:在 app.vm0.ai/connectors 连接 Segment 连接器,获得 SEGMENT_TOKEN;所有请求使用 Bearer 鉴权,Base URL 为 https://api.segmentapis.com。例如列出 Sources:curl -s "https://api.segmentapis.com/sources" --header "Authorization: Bearer $SEGMENT_TOKEN" | jq .;连通性测试可用 echo 端点 curl -s "https://api.segmentapis.com/echo?message=ok" --header "Authorization: Bearer $SEGMENT_TOKEN" | jq .。请求失败时可运行 zero doctor check-connector --env-name SEGMENT_TOKEN 或 zero doctor check-connector --url "https://api.segmentapis.com/echo?message=ok" --method GET。

适用场景:核对 Source、Destination、Tracking Plan 的配置与 ID;在更新前先读取以发现资源 ID;查看投递指标以定位数据投递异常。

限制:本连接器使用 Segment Public API 令牌做工作区配置,不提供 HTTP Tracking API 的 write keys。Public API 权限受作用域限制,返回 403 通常表示令牌缺少该资源权限。Source write keys、Destination 设置、仓库设置与投递指标应视为敏感数据。官方文档见 https://docs.segmentapis.com/。