Проверка наличия в таблице распределения
Проверьте, соответствует ли североамериканский номер префиксу в таблице распределения MultiTEL, и получите связанные с ним город, штат и страну. Это поиск по таблице префиксов. Он не подтверждает, что абонент активен, что номер назначен, что он принадлежит вашей учётной записи или что его можно заказать.
Запрос
Используйте активированную учётную запись API и разрешённый исходный IP-адрес. В примере используются учётные данные для HTTP Basic из переменных окружения и вымышленный номер. Тело запроса не требуется.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/nanpacheck/12025550123Рекомендуется указывать североамериканский номер из одиннадцати цифр, начинающийся с 1. Обработчик удаляет все символы, кроме цифр, и добавляет 1 в начало входного значения из десяти цифр. Значения с другим количеством цифр отклоняются. Такая нормализация не проверяет все правила североамериканской нумерации, поэтому успешное совпадение в таблице не является исчерпывающей проверкой номера.
Ответ
Значения полей приведены только для примера; это не результат запроса к действующей таблице распределения.
{
"status": {
"code": 200,
"msg": "12025550123"
},
"response": {
"number": "12025550123",
"npanxx": "1202555",
"city": "Example City",
"state": "DC",
"country": "US"
}
}| Поле | Значение |
|---|---|
| number | Нормализованное входное значение, содержащее только цифры. |
| npanxx | Совпавший префикс из таблицы. Обработчик отдаёт предпочтение семизначному префиксу, включающему код страны, код зоны и код телефонной станции, а при отсутствии совпадения может использовать четырёхзначный префикс с кодом страны и кодом зоны; не следует считать, что это поле всегда содержит полный код телефонной станции. |
| city, state, country | Метаданные для совпавшего префикса распределения. Эти поля не определяют текущее физическое местоположение абонента или текущего оператора после переноса номера. |
Ошибки
Проверяйте поле status.code в JSON, а не полагайтесь только на HTTP 200. Код API 404 с сообщением Not part of NANPA означает, что в используемой сервисом таблице не найден соответствующий префикс; это не является окончательным заключением всемирного органа, регулирующего нумерацию. Код API 500 используется при недопустимом количестве цифр или отсутствии номера.
Стоимость и дальнейшие действия
Проверенный обработчик выполняет запрос к локальной таблице распределения и не содержит операций списания средств с учётной записи или поиска во внешних источниках. Этот обработчик не взимает плату за поиск. Используйте поиск доступных номеров для поиска номеров, доступных для заказа. Поиск имени, поиск данных маршрутизации и заказ номера — отдельные операции, каждая из которых оплачивается по соответствующим тарифам вашей учётной записи.