Skip to content

SDK 与 API 概览

这个 Tab 面向把 ABetterChoice 接入应用代码的工程师,回答一个问题: 怎样把实验分组与云控配置取到运行时,并把曝光数据回写到平台?

当前已可用:Go 服务端 SDK 与 HTTP API。 Settings → SDK&Key 中的其他 SDK 卡片都标着 Coming soon —— 本 Tab 中各语言页面描述的是接入形态,便于你提前规划,但二进制 / 包尚未发布。 在此之前,这些运行时请改用 HTTP API。

Settings → SDK&Key 页面,展示 SDK setup 卡片网格与 API keys 列表

你可以做什么

  • 5 分钟跑通第一次接入 —— 从项目 ID 与 API key 到拿到第一条实验分组。 SDK 快速接入
  • 挑选一种接入形态 —— 服务端 SDK、客户端 SDK,还是 HTTP API。 SDK 选型
  • 在服务端用 Go SDK 接入 —— 安装、初始化、读取、上报。 Go
  • 从任何环境调用平台 —— 在没有 SDK 时签名并发送 HTTP 请求。 HTTP API
  • 理解 SDK 的契约 —— 初始化、用户对象、曝光上报、默认值与回退、本地覆盖。 SDK 概念
  • 为每次调用做认证 —— 在 Settings → SDK&Key 创建、作用域化、轮转 SDK 与 HTTP 客户端使用的 key。 API 密钥

当前可用范围

Settings → SDK&Key 页面是"什么能上线"的事实来源。今天只有 Go 服务端 SDK 与 HTTP API 正式可用,页面上其他 SDK 卡片都标着 Coming soon

SDK / 形态状态说明
HTTP APIActive任何运行时都可用;请求需签名,见 HTTP API
Go 服务端 SDKActiveGo
C++ 服务端 SDKComing soon已在 SDK setup 列出;如需提前接入,请联系支持。
Android 客户端 SDKComing soon已在 SDK setup 列出;如需提前接入,请联系支持。
iOS 客户端 SDKComing soon同 Android。
JavaScript 客户端 SDKComing soon同 Android。

SDK setup 卡片仅作展示,点击不跳转。在 Coming soon 的 SDK 上线之前,这些运行时仍可以 通过 HTTP API 接入平台。

整体关系

SDK 与 API 接入架构:项目的 API key 流向服务端 SDK、客户端 SDK 与 HTTP API,最终都连到 ABetterChoice 平台

三种接入形态对平台来说是等价的:同一个项目、同一套 key、同一组实验与开关。 按运行时挑就行。