如何使用 Fax.Plus API 购买传真号码

概述

本指南将引导您完成通过Fax.Plus API购买传真号码的流程。您将学习如何查询余额、查找可用号码，并完成购买流程。

前提条件

• 一个有效的 Fax.Plus Enterprise 账户
• API 访问凭证
• 足够的账户余额以完成购买

分步指南

1. 检查您的账户余额
   在开始购买流程之前，请确认您的账户中有足够的资金。Fax.Plus API 仅使用您的账户余额进行购买。
   GET /v3/shop/balance
   响应示例：
   {
"amount": 100,
"currency": "USD"
}了解更多：获取账户余额 - Fax.Plus API
   

   提示：请确保您的余额足以支付您想购买的号码的费用。如果您需要充值，请访问 app.fax.plus

2. 查看可用国家
   GET /v3/shop/numbers/countries
   了解更多：列出国家 - Fax.Plus API
   目前，通过 Fax.Plus API 可购买的传真号码适用于以下国家：
   
   • 🇺🇸 美国
   • 🇨🇦 加拿大
3. 查找可用地区
   选择国家后，您可以查看可购买传真号码的可用地理区域。
   GET /v3/shop/numbers/countries/{country_code}/areas
   美国地区示例：
   GET /v3/shop/numbers/countries/US/areas
   了解更多：列出地区 - Fax.Plus API
4. 搜索可用号码
   使用国家和地区筛选条件搜索传真号码：
   GET /v3/shop/numbers/countries/{country_code}/areas/{calling_code}/numbers
   搜索纽约（区域代码 212）号码的示例：
   GET /v3/shop/numbers/countries/US/areas/212/numbers
   了解更多：列出可用号码 - Fax.Plus API
5. 购买号码
   找到您想要的号码后，您可以立即购买：
   POST /v3/shop/numbers/purchase
   请求体
   {
"item_id": "<string>"
}响应
   {
"number": "<string>"
}
   

重要说明

• 余额要求：在尝试购买前，请确保您有足够的余额。
• 地理可用性：目前仅在美国和加拿大提供号码。
• 付款方式：购买仅使用您的账户余额进行处理。
• 购买失败：如果您的余额不足，购买将会失败。
  
  

了解更多：购买号码 - Fax.Plus API

故障排除

常见问题及解决方案

1. 余额不足
   • 解决方案：通过 app.fax.plus 网页界面充值。
2. 号码不再可用
   • 解决方案：号码是实时分配的。如果因号码不再可用而导致购买失败，请重新进行搜索并尝试其他号码。
3. 区域代码无效
   • 解决方案：在搜索号码之前，请使用 areas 端点仔细核对区域代码。