Чтение сохранённого тарифного плана
После просмотра доступных телефонных номеров найдите строки цен, сохранённые для вашей учётной записи API. Используйте uuid ценовой опции из списка price выбранного номера, а не его номер, ID префикса или ID области. Держите выбранный номер и ценовую опцию вместе.
Это поиск сохранённых цен в режиме совместимости. Он не обновляет доступность или цены, не резервирует номер, не размещает заказ и не гарантирует сумму будущей покупки. Перед заказом проверьте ценовую опцию, возвращённую свежим поиском номеров.
Запрос
Используйте вашу включённую учётную запись API по HTTPS с разрешённого IP-адреса. Установите PRICE_ID равным точному ID ценовой опции, который вы получили. Метод читает один аргумент пути и не принимает параметров тела, даты или пагинации.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getpriceinfo/$PRICE_ID"Этот поиск должна выполнять та же учётная запись, которая получила ценовую опцию. Не конструируйте ID, не используйте номер строки базы данных и не подставляйте выбор другой учётной записи. Устаревший метод сопоставляет только видимый ID цены.
Ответ
Следующий вымышленный пример показывает только избранные поля, предназначенные для клиентов. Реальные ответы возвращают полные сохранённые строки и могут включать дополнительные метаданные учётной записи, поставщика и внутреннего ценообразования. Храните полный ответ на вашем сервере и раскрывайте только те клиентские значения, которые нужны вашему приложению.
{
"status": {
"code": 200,
"msg": "",
"results": 1
},
"response": [
{
"visible_uuid": "PRICE_FROM_SEARCH",
"setup_price": "2.00",
"monthly_price": "4.50",
"per_minute": "0.0100",
"free_minutes": "100",
"channels": "2"
}
]
}response является списком, даже для одной строки. status.results подсчитывает возвращённые строки. Числовые значения из базы данных могут быть строками. Конечная точка не добавляет поле валюты и не конвертирует валюты; подтвердите валюту биллинга учётной записи, а не выводите её из этого примера.
Поля цены
| Поле | Значение |
|---|---|
| visible_uuid | Видимый идентификатор сохранённой ценовой опции. Используйте исходный ID опции при сопоставлении результата поиска. |
| setup_price | Сохранённая разовая цена подключения для этой опции. |
| monthly_price | Сохранённая регулярная ежемесячная цена. |
| per_minute, free_minutes | Сохранённая поминутная ставка для входящих звонков и количество включённых минут. Они не задают стоимость исходящих звонков и не учитывают все возможные надбавки. |
| channels | Сохранённое количество каналов для этой опции; это не проверка текущей ёмкости или регистрации в реальном времени. |
| yearly_price | Может присутствовать дополнительное сохранённое поле годовой цены. Не делайте вывод, что ненулевая месячная цена и нулевое годовое поле означают бесплатный годовой план. |
Обработка нескольких совпадающих строк
Поиск может вернуть более одной сохранённой строки. Метод не гарантирует порядок, не выбирает самую новую строку и не фильтрует по номеру или префиксу. Не выбирайте молча первую или последнюю строку. Сравните возвращённый контекст с исходно выбранным номером и ценовой опцией; если результат остаётся неоднозначным или устаревшим, повторите поиск номеров вместо того, чтобы считать этот ответ котировкой для заказа.
Рабочий процесс проверки заказа в портале выполняет дополнительные проверки выбора и действительности. Не предполагайте, что этот устаревший поиск реализует эти проверки или принимает каждый идентификатор, который принимает портал.
Пустые ответы и ошибки
Если ни одна сохранённая строка не совпадает, текущий обработчик не выдаёт JSON-результата и явного ответа «не найдено». Пустое тело не является нулевой ценой, доступным планом или подтверждённым успешным поиском. Проверяйте как HTTP-ответ, так и структуру JSON; не оформляйте заказ на основе отсутствующих или неразбираемых данных о цене.
Аутентификация, ограничения по IP-адресу источника и сбои базы данных также могут помешать получить пригодный ответ. Для исключения базы данных нет специфичной для обработчика обёртки ошибки. Обновите свой выбор или обратитесь в поддержку, если аутентифицированный поиск остаётся недоступным.
Эффекты и ограничения
Проверенный поиск выполняет запрос на чтение и не содержит списания, покупки, резервирования или обновления цен поставщика. Чтение сохранённых цен не устанавливает текущий инвентарь, одобрение регулятора, разрешение учётной записи на покупку или окончательный биллинг.