环境说明

区分 Sandbox 与 Live 的 Key、数据和发布版本。

API v1更新于 2026年10月20日

App 与环境

API origin 是 https://tinker.cash；HTTP 路径是 /api/v1/funnels。SDK baseUrl 只填 origin。
Sandbox 和 Live 有独立的 Key、Customer、Funnel 发布与业务数据。先在 Sandbox 测试；上线时另建 Live Key 并核对 Live 中已发布的 Funnel UUID。
X-Indiana-Project 是 App UUID，X-Indiana-Environment 是 sandbox 或 live。改 Header 不能把 Sandbox Key 升格为 Live Key。

Funnel 发布与求值模式

这条后端 Decide 路径要求目标 Funnel 在所选环境已发布，并配置 Remote 求值。新建 Funnel 默认 Local；Local 模式使用 features() 或 evaluateFunnelNode() 下载／求值规则，不能把同一示例直接当作 Remote Decide 使用。可通过 SDK 的 configuration() 核对 evaluationMode 和 versionId。

Remote 决策读取 GrowthBook 定义时，Feature、实验、Saved group 的更新可能有约 60 秒延迟；已接受决策固定其结果。Funnel 发布、Customer 属性和本次请求 attributes 不受这项规则缓存延迟影响。

版本与排查

本指南使用公开 SDK 0.5.0 与协议 0.5。SDK 自动发送版本头；手写 HTTP 请求发送 X-Indiana-Protocol: 0.5。401/403 先核对 Key、App、环境和权限；保存响应的状态码、错误码与 X-Request-Id，不记录 Key。