# 号码概述

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

## 专用号码和共享号码

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

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

`shared` 号码是 Bird 托管基础设施上的短代码。你被授权使用它而非购买它，因此没有你自己的月费，也无法释放它。尝试释放会失败并返回 [`E14002`](/docs/api/errors/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` 后才属于你，因此在此之前不应假设号码已存在。此外，已收取的开通费在订单失败时不会退还，这就是搜索和订购是两个独立调用的原因：搜索会在你提交购买之前告诉你有哪些可用号码。

## 后续步骤

- [购买和释放号码](/docs/guides/numbers/buying-numbers)介绍了通过 API 完成的完整生命周期。
- [Numbers API 参考](/docs/api/reference/list-available-numbers)记录了每个操作和字段。
- [幂等性](/docs/guides/idempotency)说明如何使重试的订单安全。

## Related resources

- [What is a virtual phone number (VMN)?](/explained/numbers/what-is-a-virtual-phone-number) (answer)
- [SMS numbers](/sms-api/features/numbers) (product)
- [Number types](/docs/guides/numbers/number-types) (docs)

[Get an implementation brief](/learn/workspace?topic=phone-numbers)