Citirea unui plan de preț salvat
Căutați rândurile de preț salvate pentru contul dvs. API după ce ați parcurs numerele de telefon disponibile. Folosiți câmpul uuid al opțiunii de preț din lista price a numărului selectat, nu numărul acestuia, ID-ul de prefix sau ID-ul de zonă. Păstrați împreună numărul selectat și opțiunea de preț.
Aceasta este o căutare de compatibilitate a prețurilor salvate. Nu reîmprospătează disponibilitatea sau prețurile, nu rezervă un număr, nu plasează o comandă și nu garantează suma unei achiziții viitoare. Verificați opțiunea de preț returnată printr-o nouă căutare de numere înainte de a comanda.
Cerere
Folosiți contul dvs. API activat prin HTTPS de la o adresă IP permisă. Setați PRICE_ID la ID-ul exact al opțiunii de preț pe care l-ați primit. Metoda citește un singur argument de cale și niciun parametru de corp, dată sau paginare.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getpriceinfo/$PRICE_ID"Această căutare trebuie efectuată de același cont care a obținut opțiunea de preț. Nu construiți un ID, nu folosiți un număr de rând din baza de date și nu înlocuiți selecția cu cea a altui cont. Metoda moștenită potrivește doar ID-ul de preț vizibil.
Răspuns
Exemplul fictiv de mai jos prezintă doar câteva câmpuri destinate clienților. Răspunsurile reale returnează rânduri salvate complete și pot include metadate suplimentare despre cont, furnizor și prețuri interne. Păstrați răspunsul complet pe serverul dvs. și expuneți doar valorile destinate clienților de care are nevoie aplicația dvs.
{
"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 este o listă, chiar și pentru un singur rând. status.results numără rândurile returnate. Valorile numerice din baza de date pot fi șiruri de caractere. Endpointul nu adaugă un câmp de monedă și nu convertește monede; confirmați moneda de facturare a contului în loc să o deduceți din acest exemplu.
Câmpuri de preț
| Câmp | Semnificație |
|---|---|
| visible_uuid | Identificatorul vizibil al opțiunii de preț salvate. Folosiți ID-ul original al opțiunii atunci când corelați căutarea. |
| setup_price | Prețul de instalare unic stocat pentru această opțiune. |
| monthly_price | Prețul lunar recurent stocat. |
| per_minute, free_minutes | Tariful pe minut stocat pentru apelurile primite și numărul de minute incluse. Acestea nu cotează apelurile efectuate și nici toate suprataxele posibile. |
| channels | Numărul de canale stocat pentru această opțiune; nu reprezintă o verificare în timp real a capacității sau a înregistrării. |
| yearly_price | Poate fi prezent un câmp suplimentar stocat pentru prețul anual. Nu deduceți că un preț lunar diferit de zero și un câmp anual egal cu zero reprezintă un plan anual gratuit. |
Gestionarea mai multor rânduri potrivite
O căutare poate returna mai mult de un rând salvat. Metoda nu oferă o ordonare garantată, o selecție a celui mai recent rând sau un filtru după număr/prefix. Nu alegeți în tăcere primul sau ultimul rând. Comparați contextul returnat cu numărul și opțiunea de preț selectate inițial; dacă rămâne ambiguu sau învechit, reîmprospătați căutarea de numere în loc să tratați acest răspuns ca pe o ofertă de comandă.
Fluxul de revizuire a comenzilor din portal efectuează verificări suplimentare de selecție și validitate. Nu presupuneți că această căutare moștenită implementează acele verificări sau acceptă fiecare identificator pe care îl acceptă portalul.
Răspunsuri goale și erori
Dacă niciun rând salvat nu se potrivește, handlerul curent nu emite niciun rezultat JSON și niciun răspuns explicit de tip „negăsit”. Un corp gol nu înseamnă un preț zero, un plan disponibil sau o căutare reușită confirmată. Verificați atât răspunsul HTTP, cât și structura JSON; nu comandați pe baza unor date de preț lipsă sau care nu pot fi analizate.
Autentificarea, restricțiile privind IP-ul sursă și defecțiunile bazei de date pot împiedica, de asemenea, un răspuns utilizabil. Nu există un înveliș de eroare specific handlerului pentru o excepție a bazei de date. Reîmprospătați selecția sau contactați asistența atunci când o căutare autentificată rămâne indisponibilă.
Efecte și limite
Căutarea revizuită efectuează o interogare de citire și nu conține nicio debitare, achiziție, rezervare sau reîmprospătare a prețului furnizorului. Citirea prețurilor salvate nu stabilește inventarul curent, aprobarea de reglementare, permisiunea de achiziție a contului sau facturarea finală.