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