eSIM API
构建完整的连接。
通过一个服务模型将连接能力引入您的应用。将目录连接到已授权的购买，跟踪履约和安装，然后帮助客户管理他们购买的服务。让您的客户体验始终掌控整个流程。
一个可以跟随的集成流程
示例BIRD · 连接
一项服务，关联记录。
1
发现与选择
读取覆盖范围、条款、价格和资格信息。
2
购买与履行
跟踪一笔已接受订单的最终结果。
3
安装与使用
完成私有配置并观察首次使用。
示意性集成流程。请参照当前的 API 契约了解支持的操作和恢复行为。
从合约开始
建模客户正在购买的服务。
Profile 标识 eSIM，套餐描述流量额度，订单记录购买。周期性订阅增加计费周期和持续服务。在应用中关联这些实体，但不要合并它们各自不同的状态。
先读后写
查询面向目标客户的可用套餐和生效能力。使用已发布的定价和当前资格信息，而非在应用中维护一份硬编码的目录。
保留已接受的意图
在购买过程中保留所选套餐和请求标识。在收到不确定的响应后跟踪已有订单，避免恢复操作变成意外的二次扣费。
构建完整流程
从购买到设备可用。
跟踪订单的财务确认和配置过程，然后提供私密的安装路径。在每个节点报告实际结果，而不是在结账完成时就标记客户已连接。
保护凭证隐私
通过已授权的客户体验获取安装凭证。将其排除在遥测数据、公开 Markdown、问题报告和通用支持消息之外。
根据观察到的状态做出响应
使用服务支持的事件和读取操作。保留观察时间，显式处理缺失信息，让界面从实际接收到的状态恢复。
运维集成
将恢复机制纳入实现。
测试一次受控的购买、安装和首次使用，再测试一次中断或被拒绝的操作。使用相同的服务标识来关联支持、财务记录和生命周期变更。
与您的编程代理协作
向代理提供当前的 API 描述和相关任务指南。让它映射支持的操作，实现已授权的流程，并展示客户最终结果的证据。
贯穿整个流程追踪获客来源
在获客和客户交接中保留推广标识。在应用中将其关联到记录的业务转化；传递查询参数只是归因的一部分。
eSIM API 常见问题
eSIM API 只是一个安装码端点吗？
不是。一个实用的集成还涵盖套餐发现、购买、交付、服务状态和持续管理。安装凭证只是该生命周期中的一个私有环节。
编码代理能完成集成吗？
代理可以基于当前的 API 描述、任务指南和你的应用来工作。让它检查支持的操作并演示一个受控的完整流程；不要仅凭营销示例就假设某个方法存在。
购买响应不确定时应如何处理？
保留原始请求和订单标识，然后使用文档中的恢复行为来确认结果。重新发起购买可能会产生额外的扣费或服务。
转化衡量应包含哪些内容？
记录你要优化的业务结果，例如完成购买或首次使用验证。在相关交接过程中保留获客上下文，并将其关联到该结果，但不要包含私有安装凭证。