Harbor组织工作区生产环境沙盒
发送代理
API 密钥 · 客户运营团队ALAlex Lee 管理员权限已更新
从可用套餐开始。
使用具有 eSIM 读取权限的服务端 API 密钥浏览目录。此示例仅列出套餐，不执行购买。
1
bird esim offers list从套餐到订单
将套餐转化为可恢复的购买。
查看套餐的覆盖范围、流量额度和有效期，然后获取当前结账价格。购买由组织钱包支付。保存生成的订单，以便在 Bird 配置 eSIM 和数据包期间客户可以随时返回查看。
展示已接受的条款
随订单一起提交已接受的套餐版本和价格。如果条款在购买前发生变更，向客户展示更新后的报价以供确认。自动续购有自己的可用条款和计划。
恢复订单而不重复购买
在创建订单前保存一个幂等键，如果响应中断则使用相同请求重试。如果你有订单 ID，先读取该订单以确认是否已完成。
托管安装
发送客户可直接打开的安装引导。
订单完成后，创建托管安装链接或通过电子邮件或 SMS 发送。客户无需登录 Bird 工作区即可打开设备专属的安装说明。消息送达的跟踪与安装和首次移动数据连接的跟踪相互独立。
控制安装访问权限
安装凭证使用单独的 API 权限。检查托管链接的过期时间，如果链接发送给了错误的人则立即撤销。撤销链接会阻止后续通过该链接访问，但不会禁用已安装的配置文件。
查看数据包余额
展示已购买的流量额度、过期时间和报告的用量及其观测时间。当用量不可用时，保持为未知状态，以便客户区分套餐额度和实测剩余余额。
后续购买
让客户为同一张 eSIM 添加数据。
在展示充值选项前，先列出现有 eSIM 的兼容套餐。充值完成后会向已安装的配置文件添加一个数据包，客户无需再次安装即可继续使用该 eSIM。
设置定期续购
如果套餐支持续订，关联使用该 eSIM 的人员并接受其续订价格和周期。跟踪每个周期的付款和数据包交付，并允许客户取消后续续订。
将客户访问保持在你的应用内
对你的客户进行身份验证，并授权他们访问各自的订单和 eSIM。工作区 API 密钥可以访问多个客户的资源，因此请将其保存在你的服务器上，并将每个资源关联到正确的账户。
eSIM API 常见问题
我可以用 eSIM API 构建什么？
将套餐浏览、数据包购买、安装链接发送和持续的套餐管理集成到你的应用中。客户可以购买兼容的充值包，并在支持的情况下订阅自动续购。你的应用负责客户身份验证及向客户收取的所有付款。
购买前需要准备什么？
需要一个 Bird 工作区、一个具有所需 eSIM 权限的服务端 API 密钥，以及组织钱包余额。购买前请查看套餐详情、结账条款和身份验证要求。读取凭证以及创建或发送安装链接需要单独的凭证权限。
购买响应中断时应如何处理？
如果你有订单 ID，直接读取该订单。否则，使用原始幂等键重复已保存的创建请求。等待该订单完成或失败后，再创建可能导致重复扣款的替代订单。
订单完成是否意味着客户已上线？
订单完成后会返回已购买的 eSIM 和数据包信息。客户仍需在兼容设备上安装配置文件，并在覆盖目的地测试移动数据。安装和余额报告可能在设备结果之后才到达。
规模扩展
不失控。
在工作区中组织团队，控制 API 访问权限，通过审计日志追踪变更。
Harbor组织有效
审计日志
生产环境- 工作区
- 生产环境
- 资源
- 发送代理
- 读取权限读写
团队 客户运营操作者角色 管理员结果 成功时间 9 月 22 日，09:42:18 UTC
成功