Как приобрести fax-номера с помощью API Fax.Plus

Обзор

Это руководство описывает процесс приобретения fax-номеров через API Fax.Plus. Вы узнаете, как проверить баланс счёта, найти доступные номера и завершить покупку.

Предварительные требования

• Активная учётная запись Fax.Plus Enterprise
• Учётные данные для доступа к API
• Достаточный баланс счёта для покупки

Пошаговое руководство

1. Проверьте баланс учётной записи
   Перед началом покупки убедитесь, что на вашем счёте достаточно средств. API Fax.Plus для покупок использует только баланс учётной записи.
   GET /v3/shop/balance
   Пример ответа:
   {
"amount": 100,
"currency": "USD"
}Подробнее: Get account balance - Fax.Plus API
   

   Совет: убедитесь, что вашего баланса достаточно для покупки нужного номера. Если требуется пополнить счёт, перейдите на app.fax.plus

2. Просмотрите доступные страны
   GET /v3/shop/numbers/countries
   Подробнее: List countries - Fax.Plus API
   В настоящее время через API Fax.Plus можно приобрести fax-номера в следующих странах:
   
   • 🇺🇸 США
   • 🇨🇦 Канада
3. Найдите доступные зоны
   После выбора страны вы можете просмотреть доступные географические зоны, в которых можно приобрести fax-номера.
   GET /v3/shop/numbers/countries/{country_code}/areas
   Пример для зон США:
   GET /v3/shop/numbers/countries/US/areas
   Подробнее: List areas - Fax.Plus API
4. Выполните поиск доступных номеров
   Выполните поиск fax-номеров с помощью фильтров по стране и зоне:
   GET /v3/shop/numbers/countries/{country_code}/areas/{calling_code}/numbers
   Пример поиска номеров в Нью-Йорке (код зоны 212):
   GET /v3/shop/numbers/countries/US/areas/212/numbers
   Подробнее: List available numbers - Fax.Plus API
5. Купите номер
   После того как вы нашли нужный номер, вы можете сразу же его приобрести:
   POST /v3/shop/numbers/purchase
   Тело запроса
   {
"item_id": "<string>"
}Ответ
   {
"number": "<string>"
}
   

Важные замечания

• Требования к балансу: перед покупкой убедитесь, что на счёте достаточно средств.
• Географическая доступность: в настоящее время номера доступны только в США и Канаде.
• Способ оплаты: покупки оплачиваются только с баланса вашего счёта.
• Неудачные покупки: если баланса недостаточно, покупка не будет выполнена.
  
  

Подробнее: Покупка номера — API Fax.Plus

Устранение неполадок

Частые проблемы и их решения

1. Недостаточный баланс
   • Решение: пополните счёт через веб-интерфейс app.fax.plus.
2. Номер больше недоступен
   • Решение: номера распределяются в режиме реального времени. Если покупка не удалась из-за того, что номер уже недоступен, выполните новый поиск и попробуйте с другим номером.
3. Неверный код зоны
   • Решение: перед поиском номеров проверьте код зоны с помощью эндпоинта areas.