Mentett árcsomag olvasása
Keresse ki az API-fiókjához mentett ársorokat az elérhető telefonszámok böngészése után. Használja az árlehetőség uuid értékét a kiválasztott szám price listájából, ne magát a számot, az előtag-azonosítót vagy a körzetazonosítót. Tartsa együtt a kiválasztott számot és az árlehetőséget.
Ez a mentett árazás kompatibilitási lekérdezése. Nem frissíti az elérhetőséget vagy az árakat, nem foglal le számot, nem ad le rendelést, és nem garantálja egy jövőbeli vásárlás összegét. Rendelés előtt ellenőrizze a friss számkereséssel visszaadott árlehetőséget.
Kérés
Használja engedélyezett API-fiókját HTTPS-en keresztül egy engedélyezett IP-címről. Állítsa a PRICE_ID értékét a kapott pontos árlehetőség-azonosítóra. A metódus egyetlen útvonal-argumentumot olvas be, és nem fogad törzs-, dátum- vagy lapozási paramétereket.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getpriceinfo/$PRICE_ID"Ezt a lekérdezést ugyanannak a fióknak kell végrehajtania, amelyik az árlehetőséget megkapta. Ne állítson össze azonosítót, ne használjon adatbázis-sorszámot, és ne helyettesítse másik fiók kiválasztásával. Az örökölt metódus csak a látható árazonosítót illeszti.
Válasz
Az alábbi kitalált példa csak válogatott, ügyfelek felé mutatható mezőket jelenít meg. A tényleges válaszok teljes mentett sorokat adnak vissza, és további fiók-, beszállítói és belső árazási metaadatokat is tartalmazhatnak. A teljes választ tartsa a saját szerverén, és csak azokat az ügyfelek felé mutatható értékeket tegye elérhetővé, amelyekre az alkalmazásának szüksége van.
{
"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 egy lista, akár egyetlen sor esetén is. A status.results mező a visszaadott sorok számát adja meg. Az adatbázis numerikus értékei sztringként is érkezhetnek. A végpont nem ad hozzá pénznemmezőt, és nem végez pénznemátváltást; a fiók számlázási pénznemét erősítse meg, ahelyett hogy ebből a példából következtetne rá.
Ármezők
| Mező | Jelentés |
|---|---|
| visible_uuid | A mentett árlehetőség látható azonosítója. A lekérdezés összevetésekor az eredeti lehetőség-azonosítót használja. |
| setup_price | Ehhez a lehetőséghez tárolt egyszeri beállítási díj. |
| monthly_price | Tárolt, ismétlődő havi díj. |
| per_minute, free_minutes | A bejövő hívások tárolt percdíja és a benne foglalt percek mennyisége. Ezek nem adnak árat a kimenő hívásokra, sem minden lehetséges felárra. |
| channels | Ehhez a lehetőséghez tárolt csatornamennyiség; nem élő kapacitás- vagy regisztrációellenőrzés. |
| yearly_price | Egy további tárolt éves díj mező is jelen lehet. Ne következtessen arra, hogy a nullától eltérő havi díj és a nulla értékű éves mező ingyenes éves csomagot jelent. |
Több egyező sor kezelése
Egy lekérdezés egynél több mentett sort is visszaadhat. A metódus nem biztosít garantált sorrendet, legfrissebb sor szerinti kiválasztást vagy szám/előtag szerinti szűrőt. Ne válassza csendben az első vagy az utolsó sort. Vesse össze a visszaadott kontextust az eredetileg kiválasztott számmal és árlehetőséggel; ha továbbra is kétértelmű vagy elavult, frissítse a számkeresést, ahelyett hogy ezt a választ rendelési árajánlatként kezelné.
A portál rendelés-ellenőrzési munkafolyamata további kiválasztási és érvényességi ellenőrzéseket végez. Ne feltételezze, hogy ez az örökölt lekérdezés megvalósítja ezeket az ellenőrzéseket, vagy hogy minden, a portál által elfogadott azonosítót elfogad.
Üres válaszok és hibák
Ha egyetlen mentett sor sem egyezik, a jelenlegi kezelő nem bocsát ki JSON-eredményt, és nem ad explicit „nem található” választ sem. Az üres törzs nem jelent nulla árat, elérhető csomagot vagy megerősített sikeres lekérdezést. Ellenőrizze a HTTP-választ és a JSON-struktúrát is; ne rendeljen hiányzó vagy nem értelmezhető áradatok alapján.
A hitelesítés, a forrás-IP-korlátozások és az adatbázis-hibák szintén megakadályozhatják a használható választ. Adatbázis-kivétel esetén nincs kezelőspecifikus hibaboríték. Frissítse a kiválasztását, vagy forduljon az ügyfélszolgálathoz, ha egy hitelesített lekérdezés továbbra sem érhető el.
Hatások és korlátok
Az átvizsgált lekérdezés olvasási lekérdezést hajt végre, és nem tartalmaz terhelést, vásárlást, foglalást vagy szolgáltatói árfrissítést. A mentett árazás olvasása nem állapítja meg az aktuális készletet, a szabályozói jóváhagyást, a fiók vásárlási jogosultságát vagy a végleges számlázást.