Načtení uloženého cenového plánu
Po procházení dostupných telefonních čísel vyhledejte cenové řádky uložené pro váš účet API. Použijte uuid cenové možnosti ze seznamu price vybraného čísla, nikoli jeho číslo, ID předvolby ani ID oblasti. Vybrané číslo a cenovou možnost uchovávejte společně.
Jedná se o vyhledání uložených cen pro zajištění kompatibility. Neaktualizuje dostupnost ani ceny, nerezervuje číslo, nezadává objednávku ani nezaručuje částku budoucího nákupu. Před objednáním zkontrolujte cenovou možnost vrácenou novým vyhledáním čísla.
Požadavek
Použijte svůj aktivovaný účet API přes HTTPS z povolené IP adresy. Nastavte PRICE_ID na přesné ID cenové možnosti, které jste obdrželi. Metoda čte jeden argument cesty a žádné parametry těla, data ani stránkování.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getpriceinfo/$PRICE_ID"Toto vyhledání musí provést stejný účet, který cenovou možnost získal. Nevytvářejte ID sami, nepoužívejte číslo řádku databáze ani nedosazujte výběr jiného účtu. Starší metoda porovnává pouze viditelné ID ceny.
Odpověď
Následující smyšlený příklad zobrazuje pouze vybraná pole určená zákazníkům. Skutečné odpovědi vracejí kompletní uložené řádky a mohou obsahovat další metadata o účtu, dodavateli a interních cenách. Úplnou odpověď uchovávejte na svém serveru a zpřístupňujte pouze hodnoty určené zákazníkům, které vaše aplikace potřebuje.
{
"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 je seznam, a to i pro jediný řádek. status.results udává počet vrácených řádků. Číselné hodnoty z databáze mohou být řetězce. Koncový bod nepřidává pole měny ani měny nepřevádí; ověřte si fakturační měnu účtu, místo abyste ji odvozovali z tohoto příkladu.
Cenová pole
| Pole | Význam |
|---|---|
| visible_uuid | Viditelný identifikátor uložené cenové možnosti. Při přiřazování výsledku vyhledání použijte původní ID možnosti. |
| setup_price | Uložená jednorázová zřizovací cena této možnosti. |
| monthly_price | Uložená opakovaná měsíční cena. |
| per_minute, free_minutes | Uložená minutová sazba příchozích hovorů a počet zahrnutých minut. Neuvádějí ceny odchozích hovorů ani všech možných příplatků. |
| channels | Uložený počet kanálů této možnosti; nejde o živou kontrolu kapacity ani registrace. |
| yearly_price | Může být přítomno další uložené pole s roční cenou. Nevyvozujte, že nenulová měsíční cena a nulové roční pole představují bezplatný roční plán. |
Zpracování více odpovídajících řádků
Vyhledání může vrátit více než jeden uložený řádek. Metoda neposkytuje zaručené řazení, výběr nejnovějšího řádku ani filtr podle čísla či předvolby. Nevybírejte mlčky první ani poslední řádek. Porovnejte vrácený kontext s původně vybraným číslem a cenovou možností; pokud zůstává nejednoznačný nebo zastaralý, zopakujte vyhledání čísla, místo abyste tuto odpověď považovali za cenovou nabídku pro objednávku.
Pracovní postup kontroly objednávky na portálu provádí další kontroly výběru a platnosti. Nepředpokládejte, že toto starší vyhledání tyto kontroly implementuje nebo že přijímá každý identifikátor, který přijímá portál.
Prázdné odpovědi a chyby
Pokud neodpovídá žádný uložený řádek, aktuální obslužná rutina nevydá žádný výsledek JSON ani explicitní odpověď typu nenalezeno. Prázdné tělo neznamená nulovou cenu, dostupný plán ani potvrzené úspěšné vyhledání. Zkontrolujte jak HTTP odpověď, tak strukturu JSON; neobjednávejte na základě chybějících nebo neanalyzovatelných cenových dat.
Použitelné odpovědi mohou bránit také ověření, omezení zdrojové IP adresy a selhání databáze. Pro výjimku databáze neexistuje žádná chybová obálka specifická pro tuto obslužnou rutinu. Pokud ověřené vyhledání zůstává nedostupné, obnovte svůj výběr nebo kontaktujte podporu.
Účinky a omezení
Zkontrolované vyhledání provádí dotaz pouze pro čtení a neobsahuje žádné stržení částky, nákup, rezervaci ani aktualizaci cen poskytovatele. Načtení uložených cen nezakládá aktuální dostupnost čísel, regulační schválení, oprávnění účtu k nákupu ani konečnou fakturaci.