号码概述

电话号码是消息和通话的发送来源。Bird 在其覆盖的国家/地区销售号码，分配到你工作区的号码可以承载 SMS、MMS 或语音，具体取决于该号码支持的功能。控制台中的 Numbers 页面显示分配给你的号码，同样的生命周期也可通过 API 完成：搜索在售号码、下单购买、查看已有号码，以及释放不再需要的号码。

专用号码和共享号码

分配给你的每个号码都有一个 kind，它决定了你可以对该号码做什么。

dedicated 号码专属于你的工作区。你购买了它，按月计费，用完后可以释放它。这就是订购号码所获得的。

shared 号码是 Bird 托管基础设施上的短代码。你被授权使用它而非购买它，因此没有你自己的月费，也无法释放它。尝试释放会失败并返回 E14002。

号码能承载什么

两个字段描述号码是什么，它们回答不同的问题。

number_type 是号码的物理类型：mobile、local、national、toll_free 或短代码。它决定号码在网络上的行为方式，以及在某些国家/地区需要什么手续。

capabilities 是号码实际能做什么：sms、mms、voice，或它们的组合。列出 voice 的号码可以承载通话；未列出的则不能。当你需要特定功能时，按能力筛选搜索结果；在基于已有号码构建之前，先检查该字段。

分配了号码并不总意味着可以用它发送。某些目的地国家/地区还要求发送方获得已批准的注册，这与号码本身的审批是分开的。

已分配号码的状态

status 表示号码是否可以承载流量。

active 表示号码已分配给你且可用。

pending_ownership_registration 表示号码已分配给你并开始计费，但所在国家要求的所有权证明文件尚未通过审核。ownership 字段会说明仍需提交的内容以及推进流程的调用。大多数号码不会进入此状态，因为大多数国家不要求任何材料：其 ownership 为 null。

released 表示号码不再分配给你。

订购是异步的

订购号码会创建一个订单，订单是你要跟踪的对象。大多数订单在请求内完成并立即返回号码。需要等待运营商处理的订单会以仍在运行的状态返回，你需要轮询它直到达到 completed 或 failed。

这很重要，原因有二。号码只有在订单为 completed 后才属于你，因此在此之前不应假设号码已存在。此外，已收取的开通费在订单失败时不会退还，这就是搜索和订购是两个独立调用的原因：搜索会在你提交购买之前告诉你有哪些可用号码。

后续步骤

• 购买和释放号码介绍了通过 API 完成的完整生命周期。
• Numbers API 参考记录了每个操作和字段。
• 幂等性说明如何使重试的订单安全。