Lue tallennettu hintasuunnitelma
Hae API-tilillesi tallennetut hintarivit sen jälkeen, kun olet selannut saatavilla olevia puhelinnumeroita. Käytä hintavaihtoehdon tunnistetta uuid valitun numeron price-luettelosta, älä sen numeroa, etuliitetunnusta tai aluetunnusta. Pidä valittu numero ja hintavaihtoehto yhdessä.
Tämä on tallennettujen hintojen yhteensopivuushaku. Se ei päivitä saatavuutta tai hintoja, ei varaa numeroa, ei tee tilausta eikä takaa tulevan oston summaa. Tarkista tuoreen numerohaun palauttama hintavaihtoehto ennen tilaamista.
Pyyntö
Käytä käytössä olevaa API-tiliäsi HTTPS-yhteydellä sallitusta IP-osoitteesta. Aseta PRICE_ID-arvoksi täsmälleen se hintavaihtoehdon tunnus, jonka sait. Metodi lukee yhden polkuargumentin eikä käytä runkoa, päivämäärä- tai sivutusparametreja.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getpriceinfo/$PRICE_ID"Haun on tehtävä sama tili, joka sai hintavaihtoehdon. Älä muodosta tunnusta itse, älä käytä tietokannan rivinumeroa äläkä korvaa valintaa toisen tilin valinnalla. Vanha metodi täsmää vain näkyvään hintatunnukseen.
Vastaus
Seuraava kuvitteellinen esimerkki näyttää vain valikoituja asiakkaalle näkyviä kenttiä. Todelliset vastaukset palauttavat täydelliset tallennetut rivit ja voivat sisältää lisäksi tiliin, toimittajaan ja sisäiseen hinnoitteluun liittyviä metatietoja. Säilytä koko vastaus palvelimellasi ja näytä vain ne asiakkaalle tarkoitetut arvot, joita sovelluksesi tarvitsee.
{
"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 on luettelo myös silloin, kun rivejä on vain yksi. status.results kertoo palautettujen rivien määrän. Tietokannan numeeriset arvot voivat olla merkkijonoja. Päätepiste ei lisää valuuttakenttää eikä muunna valuuttoja; varmista tilin laskutusvaluutta sen sijaan, että päättelisit sen tästä esimerkistä.
Hintakentät
| Kenttä | Merkitys |
|---|---|
| visible_uuid | Tallennetun hintavaihtoehdon näkyvä tunniste. Käytä alkuperäistä vaihtoehdon tunnusta, kun yhdistät haun tuloksia alkuperäiseen valintaan. |
| setup_price | Tämän vaihtoehdon tallennettu kertaluonteinen perustamishinta. |
| monthly_price | Tallennettu toistuva kuukausihinta. |
| per_minute, free_minutes | Saapuvien puhelujen tallennettu minuuttihinta ja sisältyvien minuuttien määrä. Nämä eivät kerro lähtevien puhelujen hintaa eivätkä kaikkia mahdollisia lisämaksuja. |
| channels | Tämän vaihtoehdon tallennettu kanavamäärä; se ei ole reaaliaikainen kapasiteetti- tai rekisteröintitarkistus. |
| yearly_price | Vastauksessa voi olla lisäksi tallennettu vuosihintakenttä. Älä päättele, että nollasta poikkeava kuukausihinta ja nolla-arvoinen vuosikenttä tarkoittaisivat ilmaista vuosisuunnitelmaa. |
Useiden täsmäävien rivien käsittely
Haku voi palauttaa useamman kuin yhden tallennetun rivin. Metodi ei takaa järjestystä, ei valitse uusinta riviä eikä tarjoa numero-/etuliitesuodatinta. Älä valitse ensimmäistä tai viimeistä riviä hiljaisesti. Vertaa palautettua kontekstia alun perin valittuun numeroon ja hintavaihtoehtoon; jos tulos on edelleen moniselitteinen tai vanhentunut, päivitä numerohaku sen sijaan, että käsittelisit tätä vastausta tilaustarjouksena.
Portaalin tilauksen tarkistustyönkulku tekee lisää valinta- ja kelpoisuustarkistuksia. Älä oleta, että tämä vanha haku toteuttaa nämä tarkistukset tai hyväksyy kaikki portaalin hyväksymät tunnisteet.
Tyhjät vastaukset ja virheet
Jos yksikään tallennettu rivi ei täsmää, nykyinen käsittelijä ei tuota JSON-tulosta eikä nimenomaista ei löytynyt -vastausta. Tyhjä runko ei tarkoita nollahintaa, saatavilla olevaa suunnitelmaa eikä vahvistettua onnistunutta hakua. Tarkista sekä HTTP-vastaus että JSON-rakenne; älä tilaa puuttuvien tai jäsentymättömien hintatietojen perusteella.
Myös todennus, lähde-IP-rajoitukset ja tietokantavirheet voivat estää käyttökelpoisen vastauksen. Tietokantapoikkeukselle ei ole käsittelijäkohtaista virhekuorta. Päivitä valintasi tai ota yhteyttä tukeen, jos todennettu haku ei edelleenkään ole käytettävissä.
Vaikutukset ja rajoitukset
Tarkastettu haku suorittaa lukukyselyn eikä sisällä veloitusta, ostoa, varausta eikä toimittajahinnan päivitystä. Tallennettujen hintojen lukeminen ei vahvista nykyistä varastotilannetta, viranomaishyväksyntää, tilin osto-oikeutta eikä lopullista laskutusta.