Читання збереженого тарифного плану
Після перегляду доступних телефонних номерів знаходьте рядки цін, збережені для вашого облікового запису 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-адресою та збої бази даних також можуть завадити отриманню придатної відповіді. Для винятку бази даних не існує специфічної для обробника обгортки помилки. Оновіть свій вибір або зверніться до служби підтримки, якщо автентифікований пошук залишається недоступним.
Наслідки та обмеження
Перевірений пошук виконує запит на читання й не містить списання коштів, покупки, резервування чи оновлення цін постачальника. Читання збережених цін не встановлює поточного запасу номерів, регуляторного схвалення, дозволу облікового запису на покупку чи остаточного білінгу.