共 84 个普通操作,其中 78 个可用、6 个保留接口返回 HTTP 501;另有 25 个 Funnel 命令和 6 个公开配置与实验接口。每个操作都按凭据、权限与 App/环境作用域执行。
- 点击接口查看请求示例、请求体参数、响应字段与对应的 SDK 方法。
- JavaScript SDK 的方法名与操作名相同:Server Key 操作在
createIndianaServer上,Customer Token 操作在浏览器的createIndiana上。
每个 HTTP 操作的路径、凭据、权限、SDK 方法与说明,以及 Funnel 命令和公开接口。
共 84 个普通操作,其中 78 个可用、6 个保留接口返回 HTTP 501;另有 25 个 Funnel 命令和 6 个公开配置与实验接口。每个操作都按凭据、权限与 App/环境作用域执行。
createIndianaServer 上,Customer Token 操作在浏览器的 createIndiana 上。按 externalUserId 或 email 查找或创建 Customer;已有资料不会被覆盖。
/api/v1/customers按 Customer UUID 或 externalUserId 读取 Customer。
/api/v1/customers/get按搜索词、标签、Product、状态和创建时间筛选并分页。
/api/v1/customers/list以保留的 requestId 部分更新资料、属性和标签;重放返回原结果。
/api/v1/customers/update后端验证用户后签发 Customer Token,供浏览器或 App 使用。
/api/v1/customer-sessions为同一 Customer 轮换仍有效的 Customer Token。
/api/v1/customer-sessions/renew撤销指定会话或该 Customer 的全部会话。
/api/v1/customer-sessions/revoke用后端生成并保存的 guestToken 创建或恢复访客。
/api/v1/customers/guests为已验证的访客签发 Customer Token。
/api/v1/customers/guests/session登录后把访客绑定到 externalUserId;已有 Customer 时切换身份,不合并历史。
/api/v1/customers/guests/claim检查 Feature 需求是否满足;只观察,不扣减用量。
/api/v1/entitlements/check解析已发布的 Offering Version、候选 Product 与可购买状态。
/api/v1/offerings/resolve解析独立 Paywall、固定的 Offering Version 与展示内容。
/api/v1/paywalls/resolve读取 Customer 或 Entity 的会员、购买和余额事实。
/api/v1/customer-holdings读取单个余额来源及其版本和状态。
/api/v1/balances/source/read以预期可用量为前提增加、扣减、设定或编辑余额来源。
/api/v1/balances/source/adjust读取 Feature(可选 Entity)在当前周期的用量。
/api/v1/usage/read以管理权限直接设定用量;日常消耗使用 trackUsage。
/api/v1/usage/set创建、更新、调整或撤销余额发放(含过期、重置和结转)。
/api/v1/balances/grants/manage分页列出 Customer 的余额发放。
/api/v1/balances/grants/list创建/更新或归档 Customer 下的 Entity(如工作区、设备)。
/api/v1/usage/entities读取作用域内的用量聚合。
/api/v1/usage/analytics读取由余额与财务记录得出的额度分析。
/api/v1/credits/analytics以 requestId 受理一批用量(HTTP 202),逐项保留消费身份。
/api/v1/usage/batch分页读取用量批次的逐项结果。
/api/v1/usage/batch/read读取 Customer 账本页及其业务引用。
/api/v1/customer-ledger按时间区间和快照读取一致的额度对账单。
/api/v1/credit-statements/read预估一次消耗的结果;不扣减、不预留、不收费。
/api/v1/balances/quote按事件名或 Feature 上报用量,返回逐条受理回执。
/api/v1/usage/track执行余额的报价、消耗、预留、确认、退回或释放。
/api/v1/balances/execute开始收集付款方式;本身不扣款、不开票。
/api/v1/billing/setup-payment读取付款方式收集的结果。
/api/v1/billing/payment-setup核对 Customer 的订阅事实与归属,不发起扣款。
/api/v1/subscriptions/verify为所选 Product、Provider 与币种生成固定报价和 operationId;不扣款。
/api/v1/subscriptions/preview-attach确认或取消已报价的购买;结果由交易与签名回调决定。
/api/v1/subscriptions/attach读取购买操作的当前状态;结果未知时用它恢复。
/api/v1/subscriptions/operations/read为升级、降级或取消生成固定报价,可选立即、续订或商店时点生效。
/api/v1/subscriptions/preview-update确认或取消已报价的订阅变更。
/api/v1/subscriptions/update读取订阅变更操作及其恢复状态。
/api/v1/subscriptions/updates/read按 Customer、Entity、Product、Provider 与状态分页列出订阅。
/api/v1/subscriptions/list分页列出购买记录及其状态。
/api/v1/purchases/list列出订阅冲突及可执行的下一步,不修改订阅。
/api/v1/subscriptions/conflicts/list按原 orderId 重试已记录的冲突。
/api/v1/subscriptions/conflicts/retry开始、延长或结束试用。
/api/v1/subscriptions/trials/manage读取已记录的试用操作。
/api/v1/subscriptions/trials/read批量订阅报价(保留契约)。
/api/v1/subscriptions/batches/preview确认批量订阅(保留契约)。
/api/v1/subscriptions/batches/confirm读取批量订阅(保留契约)。
/api/v1/subscriptions/batches/read放弃批量订阅(保留契约)。
/api/v1/subscriptions/batches/abandon读取当前环境的发票模板。
/api/v1/invoices/templates预览发票金额与行项目,不创建发票。
/api/v1/invoices/preview以 requestId 受理开票任务并返回操作。
/api/v1/invoices/create创建、定稿、发送、收款、作废或重开发票。
/api/v1/invoices/manage按 taskId 读取开票操作。
/api/v1/invoices/operations/read分页列出 Customer 的发票。
/api/v1/invoices/list读取单张发票及其行项目。
/api/v1/invoices/read预估全额或部分退款及权益处理;不退款。
/api/v1/subscriptions/refunds/preview确认已报价的退款;重放不会重复退款。
/api/v1/subscriptions/refunds/confirm读取退款操作的结果。
/api/v1/subscriptions/refunds/readCustomer 读取自己的用量计费与自动充值设置。
/api/v1/billing/controls/read准备自动充值授权条款,等待 Customer 明确同意。
/api/v1/billing/authorizations/prepare记录 Customer 对授权的明确同意。
/api/v1/billing/authorizations/confirm为会员设定要使用的已领取优惠。
/api/v1/billing/coupons撤销已同意的计费授权。
/api/v1/billing/authorizations/revokeCustomer 分页读取自己的账单。
/api/v1/billing/invoices/read后端为 Customer 设置用量上限、提醒阈值和超额规则。
/api/v1/billing/controls/manage分页读取一张账单的明细。
/api/v1/billing/invoices/detail确认账单调整(保留契约)。
/api/v1/billing/invoices/confirm-adjustmentCustomer 输入券码兑换优惠。
/api/v1/offers/redeem列出当前 Customer 可用的优惠。
/api/v1/offers后端定向发券(offers:grant),或 Customer 自助领取(offers:resolve)。
/api/v1/offers/grant后端记录已核实的用券事实,按 eventId 去重。
/api/v1/offers/redemptionsCustomer 用兑换码或推荐码兑换奖励。
/api/v1/rewards/redeem为 Customer 在推荐计划中生成推荐码。
/api/v1/rewards/referral-code领取奖励 Product(保留契约)。
/api/v1/rewards/product/claim全部发送到 POST /api/v1/funnels,由 JSON 字段 operation 选择。Server Key 启动 Run 与服务端命令需要 funnels:run 和 sessions:create;用 externalUserId 创建 Customer 还需要 customers:write。
| operation | 凭据 | 说明 |
|---|---|---|
start | Server Key 或 Customer Token | 在固定的 Funnel Version 启动 Run,返回 Run Token。 |
get | Run Token + 原身份证明 | 读取 Run 与当前指令。 |
resume | Run Token + 原身份证明 | 恢复原 Run,保留已受理的工作与等待。 |
submit | Run Token + 原身份证明 | 提交当前界面的输入。 |
back | Run Token + 原身份证明 | 在允许的位置返回上一步。 |
shown | Run Token + 原身份证明 | 记录界面已实际展示。 |
close | Run Token + 原身份证明 | 按停止规则关闭交互。 |
commit_segment | Run Token + 原身份证明 | 提交 Local 模式的一段纯计算步骤,由服务端复核。 |
evaluate | Run Token + 原身份证明 | Local 模式的单节点求值回报;新集成使用 commit_segment。 |
review | Run Token + 原身份证明 | 读取历史展示或回执,不恢复执行。 |
decide | Server Key | 为指定 Customer 与属性请求后端决策。 |
read_decision | Server Key | 按 decisionId 读取原决策。 |
evaluate_decision | Server Key | 为原决策提交一次纯求值结果。 |
feature_config | Server Key | 读取允许下载的 Feature 配置。 |
commit_decision_segment | Server Key | 提交原决策的 Local 步骤。 |
segment_configuration | Server Key | 读取已发布版本的求值片段。 |
configuration | Server Key | 读取 Funnel 配置,核对版本与求值模式。 |
local_configuration | Server Key | 读取 Local SDK 使用的配置。 |
report_used | Server Key | 记录调用方报告的采纳,按 eventId 去重。 |
campaign_decide | Server Key | Campaign 决策。 |
campaign_start | Server Key | 按冷却时间启动 Campaign,或返回抑制原因。 |
renew_run | Server Key | 轮换 Run Token。 |
signal | Server Key | 向等待中的 Run 提交外部事件。 |
read_results | Server Key | 读取 Run 已受理的结果。 |
resolve_screen | Server Key 或已识别的 Customer Token | 解析 Local 界面需要的资源状态与优惠摘要。 |
Funnel 命令
start
get
resume
submit
back
shown
close
commit_segment
evaluate
commit_segment。review
decide
read_decision
evaluate_decision
feature_config
commit_decision_segment
segment_configuration
configuration
local_configuration
report_used
campaign_decide
campaign_start
renew_run
signal
read_results
resolve_screen
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/v1/configuration/{environmentId} | 已发布的 SDK 公开配置清单;支持 ETag/304。 |
| GET | /api/v1/configuration/{environmentId}/artifacts/{digest} | 清单引用的公开配置文件,按 SHA-256 校验。 |
| GET | /api/v1/page-experiments/{environmentId} | URL 跳转实验配置。 |
| POST | /api/v1/page-experiments/{environmentId}/events | URL 跳转实验的曝光与事件;校验 Origin。 |
| GET | /api/v1/visual-experiments/{environmentId} | 可视化实验配置。 |
| POST | /api/v1/visual-experiments/{environmentId}/events | 可视化实验的曝光与事件;校验 Origin。 |
无需凭据的公开接口
GET
/api/v1/configuration/{environmentId}GET
/api/v1/configuration/{environmentId}/artifacts/{digest}GET
/api/v1/page-experiments/{environmentId}POST
/api/v1/page-experiments/{environmentId}/eventsGET
/api/v1/visual-experiments/{environmentId}POST
/api/v1/visual-experiments/{environmentId}/events