Läs en sparad prisplan
När du har bläddrat bland tillgängliga telefonnummer slår du upp de prisrader som sparats för ditt API-konto. Använd prisalternativets uuid från listan price för det valda numret, inte dess nummer, prefix-ID eller områdes-ID. Håll ihop det valda numret och prisalternativet.
Detta är en kompatibilitetsuppslagning av sparad prissättning. Den uppdaterar inte tillgänglighet eller priser, reserverar inget nummer, lägger ingen beställning och garanterar inte beloppet för ett framtida köp. Granska det prisalternativ som returneras med en ny nummersökning innan du beställer.
Begäran
Använd ditt aktiverade API-konto över HTTPS från en tillåten IP-adress. Sätt PRICE_ID till exakt det prisalternativ-ID du fick. Metoden läser ett sökvägsargument och inga body-, datum- eller pagineringsparametrar.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getpriceinfo/$PRICE_ID"Samma konto som fick prisalternativet måste göra denna uppslagning. Konstruera inte ett ID, använd inte ett databasradnummer och ersätt inte med ett annat kontos val. Den äldre metoden matchar endast det synliga pris-ID:t.
Svar
Följande fiktiva exempel visar endast ett urval av kundvända fält. Verkliga svar returnerar kompletta sparade rader och kan innehålla ytterligare konto-, leverantörs- och intern prismetadata. Behåll hela svaret på din server och exponera endast de kundvända värden som din applikation behöver.
{
"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 är en lista, även för en enda rad. status.results räknar de returnerade raderna. Numeriska databasvärden kan vara strängar. Slutpunkten lägger inte till något valutafält och konverterar inte valutor; bekräfta kontots faktureringsvaluta i stället för att härleda den från detta exempel.
Prisfält
| Fält | Betydelse |
|---|---|
| visible_uuid | Det sparade prisalternativets synliga identifierare. Använd det ursprungliga alternativ-ID:t när du korrelerar uppslagningen. |
| setup_price | Lagrat engångspris för uppsättning för detta alternativ. |
| monthly_price | Lagrat återkommande månadspris. |
| per_minute, free_minutes | Lagrad minutavgift för inkommande samtal och antal inkluderade minuter. Dessa anger inte priset för utgående samtal eller varje möjlig tilläggsavgift. |
| channels | Lagrat antal kanaler för detta alternativ; det är inte en realtidskontroll av kapacitet eller registrering. |
| yearly_price | Ett ytterligare lagrat fält för årspris kan förekomma. Dra inte slutsatsen att ett månadspris skilt från noll och ett årsfält med värdet noll innebär en gratis årsplan. |
Hantera flera matchande rader
En uppslagning kan returnera mer än en sparad rad. Metoden ger ingen garanterad ordning, inget val av senaste rad och inget nummer-/prefixfilter. Välj inte tyst den första eller sista raden. Jämför den returnerade kontexten med det ursprungligen valda numret och prisalternativet; om det fortfarande är tvetydigt eller inaktuellt, uppdatera nummersökningen i stället för att behandla detta svar som en beställningsoffert.
Portalens arbetsflöde för beställningsgranskning utför ytterligare urvals- och giltighetskontroller. Anta inte att denna äldre uppslagning implementerar dessa kontroller eller accepterar varje identifierare som portalen accepterar.
Tomma svar och fel
Om ingen sparad rad matchar skickar den nuvarande hanteraren inget JSON-resultat och inget uttryckligt not-found-svar. En tom body är inte ett nollpris, en tillgänglig plan eller en bekräftad lyckad uppslagning. Kontrollera både HTTP-svaret och JSON-strukturen; beställ inte utifrån saknade eller otolkbara prisdata.
Autentisering, käll-IP-begränsningar och databasfel kan också förhindra ett användbart svar. Det finns inget hanterarspecifikt felkuvert för ett databasundantag. Uppdatera ditt val eller kontakta supporten när en autentiserad uppslagning förblir otillgänglig.
Effekter och begränsningar
Den granskade uppslagningen utför en läsfråga och innehåller ingen debitering, inget köp, ingen reservation och ingen uppdatering av leverantörspriser. Att läsa sparad prissättning fastställer inte aktuellt lager, myndighetsgodkännande, kontots köpbehörighet eller slutlig fakturering.