区分公共目录与私人接收
公开数据描述服务、国家、价格和时长。不包含分配的电话号码或代码。激活属于账户和订单，私有追踪分开管理。
服务和国家目录独立于商业报价。集成合同要求API目录提供权威的价格和可用性以供下单。
目录与订购
现有合同指定 GET /catalog/products 和 GET /catalog/products/:slug。后端提供权威价格、时长和明确可用性；缺货状态未知。
订单发送产品标识符及幂等键。服务器在预订或分配前检查价格和库存。浏览页面不会触发敏感操作。
接收状态
模块区分分配、等待、已接收、已完成、已取消、已过期和失败。分配可在无号码时待定；真正的等待和接收需要后端的号码和过期时间。
每条消息都有稳定的标识符、时间戳和文本。后端可能提供提取的代码；界面不得猜测一次性密码。公共目录不包含分配的电话号码或私人代码。
授权操作与更新
GET /activations 和 GET /activations/:id 是私有读取。POST /activations/:id/actions 发送取消、完成或重发请求，带幂等键。后端会宣布并重新检查允许的操作。
私人读取使用会话、界面语言和适当缓存。跟踪间隔遵循合同；服务器过期和状态优先于浏览器计时器。
支付、分配和供应商机密
发票确定资产、网络、金额、地址和到期。付款确认与号码分配是不同事件。后端处理失败和重试，无重复分配。
提供商密钥和支付密钥保留在服务器。API授权每次账户读取，定义消息保留并保持内部提供商标识私密。此页记录集成协议，不发布公开运营API。
合同端点参考
| 方法 | 端点 | 角色 |
|---|---|---|
GET | /catalog/products | 公开目录 |
GET | /activations | 账户激活 |
GET | /activations/:id | 私人接收追踪 |
POST | /activations/:id/actions | 授权操作 |
这些是现有前端合同路径，非发布的生产端点。供应商、认证和支付集成尚待连接。