申请租用一个电话号码，初始租期为30天。国家和首选区号均可选，未指定国家时默认申请美国号码；购买成功后会返回分配的号码和到期时间。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
BlockRun
申请租用一个电话号码，初始租期为30天。国家和首选区号均可选，未指定国家时默认申请美国号码；购买成功后会返回分配的号码和到期时间。
购买成功后会返回分配的电话号码、初始租期到期时间、供应商付款网络和号码开通提示。智能体可以把号码和到期时间整理在一起，方便查看租赁期限。
租用[国家或地区]的电话号码30天，首选[区号]。
初始租期为30天，不代表永久拥有号码。此次购买不会拨打电话，也不提供短信或入站接听服务。后续通话和续租需要另行操作，并满足供应商对号码所关联付款钱包的要求。国家号码库存及首选区号均不保证可用。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
购买偏好body | object | 选填 | 用于填写国家和区号偏好的可选对象。不填写这些偏好时，按默认的美国号码分配请求处理。 |
国家body.country | string | 选填 | 可选的 ISO 两位字母国家代码，例如 US 或 CA。省略时请求美国号码；需满足号码库存和运营商审批条件。 |
首选区号body.areaCode | string | 选填 | 可选的首选区号；美国或加拿大使用三位数字。没有符合区号的号码时，供应商可能分配同一国家的其他号码。 |
{
"type": "object",
"required": [],
"properties": {
"body": {
"type": "object",
"required": [],
"properties": {
"country": {
"type": "string",
"description": "ISO 两位字母国家代码，默认 US；CA 通常可直接使用。其他国家（如 MX、BR、AR、CL、CO）需要账户配置 Twilio Regulatory Bundle；若返回 502 并提示 regulatory bundle required，请联系 care@blockrun.ai。"
},
"areaCode": {
"type": "string",
"description": "首选区号（美国/加拿大为 3 位数字）；不保证一定可用，若无匹配号码，Twilio 会返回该国其他号码。"
}
}
}
},
"additionalProperties": false
}暂未配置返回字段说明。
BlockRun 电话号码购买文档 将 phone_number 说明为按 E.164 国际格式表示的已分配号码，以加号和国家代码开头。expires_at 是 ISO 格式的 UTC 租期到期时间。应以实际返回的到期时间为准，不能理解为长期持有号码。
chain 表示供应商请求使用的付款网络，并不标识个人钱包。message 是号码开通确认和操作提示。购买提示不能证明已经拨打过电话。
供应商将号码租赁登记在购买请求使用的钱包名下。后续使用和续租需要满足这一归属要求。收到号码本身，并不能证明你的个人钱包对它具有控制权。
默认国家为美国。加拿大号码取决于可用库存；其他国家可能需要先在供应商账户上完成运营商的合规审批，才能申请号码。填写国家代码或首选区号，并不保证有符合偏好的号码。
直接填写[美国]或[加拿大]这样的名称，不必输入缩写。省略时默认请求美国号码。也可填写[区号，例如212]，但不保证有匹配号码。其他国家或地区可能无法租用。
租用[国家或地区]的电话号码30天，首选[区号]。
查看实际分配的号码和租期结束日期。此请求不会拨打电话或显示短信；这些功能需要另行支持。
供应商说明，到期后号码会被收回并重新进入号码池。希望继续使用时，需要在到期前另行续租；此次购买不提供永久所有权。
运营商审批在供应商账户上办理。因合规限制无法申请时，BlockRun 建议通过 care@blockrun.ai 联系并说明需要的国家。审批及号码库存与区号偏好是不同的条件。