火山引擎 DataFinder

在连接器的 访问内容 → 添加访问 中，从 服务预设 选择 火山引擎 DataFinder。

获取与填写凭证

这里需要 DataFinder 产品的 OpenAPI AK/SK。在 DataFinder 的产品管理或 API 访问配置中获取，或向对应项目的 DataFinder 管理员申请，并确认该密钥已获得所需项目的数据权限。私有化部署时，按该部署的 DataFinder 管理员提供的入口获取。

分别填写 Access Key ID 和 Secret Key，不要把已生成的 Authorization 签名当作密钥填入。DataFinder 的 OpenAPI 凭证和调用方式与火山引擎其他 OpenAPI 不同。

官方说明：DataFinder OpenAPI 调用方式。

服务地址

默认地址为 https://analytics.volcengineapi.com；BytePlus 可使用 https://analytics.byteplusapi.com。私有化部署以 DataFinder 管理员提供的服务地址为准。推荐配置限定 /datafinder/openapi/v1，默认允许 GET 和 POST；其他方法或路径在 自定义 中按实际 API 设置。

分析查询范围

在 请求规则 的 限制方式 中选择 DataFinder 分析资源，填写允许查询的 App ID，或添加 Project。选择后，地址会自动限定为 POST /datafinder/openapi/v1/analysis；其他路径可在自定义配置中单独添加。每组凭证最多填写 100 个 App ID、添加 100 个 Project，每个 Project 内最多 100 个 App ID。

Project 默认选择 指定应用，必须填写 App ID；只有显式选择 全部应用（含后续新增） 才允许整项目查询。查询只给出 App ID 时，这些 App 必须在 App ID 或某个 Project 的 指定应用 中明确列出，整项目授权不会覆盖单独给出的 App ID。

同一服务地址可以添加多组 DataFinder 凭证，各自授权不同的 App 或 Project；平台按每次查询涉及的资源选用对应凭证。一次查询的资源必须落在同一组凭证内，多组的范围不要重叠。

ZAI 了解 DataFinder 查询请求的格式要求，这里不需要配置；需要额外约束时，写进连接器的使用指令。

分析接口以外的其他接口，可以在 限制方式 中选择 按请求字段限制，为请求头、查询参数或 JSON 正文添加条件。所有条件都要同时满足；数组非空且全部属于集合 要求数组非空。

验证

保存后请 ZAI 用一个已授权的只读查询访问目标资源。只有响应体中的 code 为 200 才表示查询成功。出现签名错误时，先核对 DataFinder AK/SK 是否配对、服务地址是否正确，再核对请求规则和 DataFinder 账号权限。其余排查见验证与排错。