Bevestig dat mobiele voorraad is ingeschakeld
Gebruik deze zoekopdracht alleen nadat mobiele nummervoorraad is ingeschakeld voor uw klantaccount. Verkrijg een actueel individueel mobiel prefix via de discovery-werkstroom van het account. Het ondersteunde pad vraagt draadloze voorraad aan voor dat prefix. Het is niet afhankelijk van een overeenkomende wireline-routeringsmetadatarecord. Neem contact op met support als u niet zeker weet of uw account of prefix is ingeschakeld.
De huidige legacyroute wijst niet elke niet in aanmerking komende aanvraag betrouwbaar af. Een account zonder ingeschakelde mobiele voorraad kan gewone voorraad ontvangen terwijl het antwoord nog steeds info.is_mobile: 1 zegt. Een toll-free-prefix kan ook de toll-free-voorraadtak met dat label bereiken. Gebruik dit label niet alleen om mobiele service te identificeren, en stuur geen gewone of toll-free-prefixes naar dit endpoint. Gebruik de bevestigde mobiele catalogus van het account en de ingeschakelde werkstroom.
Houd elk nummer bij zijn eigen prijselectie
Houd voor elke kandidaat number, info.uuid en de price-lijst van dezelfde entry bij elkaar. Het antwoord bevat ook prefix/gebied/land-metadata, contractvoorwaarden en registratiebeperkingen. Kandidaten zijn gesorteerd op de maandprijs van hun eerste prijsoptie, oplopend; er is geen gegarandeerde stabiele volgorde voor gelijke prijzen. Vervang het geretourneerde nummer-ID niet door een gebieds- of prefix-ID, en koppel het niet aan de prijs-ID van een andere kandidaat.
Het volledige antwoord kan aanvullende metadata- en prijsvelden bevatten. De geretourneerde features, kanaalwaarden en restrictions beschrijven de kandidaat; ze zijn geen garantie dat bellen, sms, mms of fax al bruikbaar zijn. Accountrechten, registratie en het geselecteerde serviceplan blijven van toepassing. Beschouw de placeholders van het voorbeeld niet als geldige id's of prijzen.
Gebruik een klein positief aantal
Begin met een aantal van 1. De normale provideraanvraag normaliseert een niet-positief aantal naar 1 en beperkt de upstreamwaarde tot 300, maar latere resultaatverwerking gebruikt nog steeds de oorspronkelijke invoer. Een nulaantal kan daardoor upstream-voorraad aanvragen en geen kandidaten retourneren. Andere legacy-takken handhaven het gevraagde resultaantal niet consequent. Vertrouw niet op één universeel maximum en stuur geen negatieve, fractionele of niet-numerieke waarden. Er is geen ondersteunde openbare zoekfilter- of prijs-ID-bodyparameter gedocumenteerd voor deze route.
Onderscheid gebrek aan voorraad van een mislukte opzoeking
Een 404-antwoord kan niet-beschikbare voorraad, uitgeschakelde service, een mislukte leveranciersopzoeking of ongeldige catalogusrecords betekenen. Beschouw een time-out of providerfout als onbekende beschikbaarheid, niet als bevestigd nulvoorraad. Vernieuw de selectie en probeer opnieuw met backoff waar passend. Vermijd het herhaaldelijk bevragen van elke exchange. Het aparte endpoint voor het aantal mobiele nummers is een momentopname-hint en hoeft niet overeen te komen met de lengte van de kandidatenlijst van dit account.
Controleer opnieuw voordat u koopt
Zoeken reserveert geen voorraad. De beoordeelde tak probeert al gekochte nummers uit te sluiten, maar een mislukte lokale reserveringsopzoeking kan zo'n kandidaat in het resultaat laten staan. Beschikbaarheid, eigendom, goedgekeurde prijzen en registratie moeten door de aankoopwerkstroom worden gecontroleerd. Gebruik een verse selectie met de beveiligde aankoopaanvraag en stem de accountvoorraad af na elk onzeker aankoopresultaat voordat u het opnieuw probeert. Koop nooit alleen omdat een kandidaat is geretourneerd.
Aanvraag
Gebruik een ingeschakeld API-account via HTTPS vanaf een toegestaan bron-IP-adres. Mobiele voorraad moet ook zijn ingeschakeld voor het klantaccount; API-authenticatie alleen schakelt het niet in.
GET met de actuele individuele prefix-id en een positief geheel getal als aantal in het URL-pad. Het aantal staat standaard op 1 indien weggelaten. Gebruik het voorbeeld met 1; deze route valideert of handhaaft niet consequent een universele resultaatlimiet.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getmobiles/$PREFIX_ID/1"| Naam | Type | Vereist | Beschrijving |
|---|---|---|---|
prefix_id | string | Ja | De ondoorzichtige zichtbare id van een in aanmerking komend individueel mobiel prefix uit discovery. Gebruik een mobiel NPA/NXX-exchangeprefix dat door uw account wordt ondersteund; substitueer geen gebieds-id, gegroepeerde weergave-id, letterlijk kiesprefix of toll-free-prefix. |
quantity | integer | Nee | Gevraagd aantal kandidaten. Standaard 1. Geef een bescheiden positief geheel getal op. De normale upstream-aanvraag beperkt het aantal tot 300, maar dat is geen universeel gevalideerde invoer of garantie op de responsgrootte. |
Antwoord
Inspecteer status.code en status.msg in de JSON-body en ook de HTTP-status. Bij succes is response een lijst van nummerkandidaten, is status.msg Results: gevolgd door het geretourneerde aantal, en is status.results de geserialiseerde lijstlengte. Kandidaatprijzen zijn accountspecifiek. Het verduidelijkende verkorte voorbeeld gebruikt placeholders in plaats van echte voorraad of een tariefofferte. Nummers bevatten de landcode zonder plusteken; id's zijn ondoorzichtige strings.
Verduidelijkende responsvorm; geen live accountgegevens of actuele offerte.
{
"status": {
"code": 200,
"msg": "Results: 1",
"results": 1
},
"response": [
{
"number": "12025550123",
"info": {
"uuid": "NUMBER_ID",
"prefix_uuid": "PREFIX_ID",
"country_iso": "US",
"is_mobile": 1
},
"price": [
{
"uuid": "PRICE_ID",
"monthly_price": "ACCOUNT_MONTHLY_PRICE",
"setup_price": "ACCOUNT_SETUP_PRICE",
"per_minute": "ACCOUNT_INCOMING_RATE",
"channels": "PLAN_CHANNELS"
}
],
"features": [
"voice",
"sms",
"mms",
"t38"
]
}
]
}Fouten
- 404: Ongeldige prefix-id, land of gebied: vernieuw de selectie van het individuele mobiele prefix.
- 404: Geen nummers gevonden: kan geen bruikbare voorraad, uitgeschakelde service, mislukte provideropzoeking, niet-ondersteunde selectie of accountbeperkingen betekenen. Het is geen bewijs van een autoritatief nul-voorraadantal.
Beschikbaarheid en neveneffecten
- Zoeken huurt of reserveert geen nummer en het beoordeelde pad debiteert geen aankoopbedrag. Het neemt contact op met de voorraadprovider en kan tijd kosten.
- Succesvolle zoekopdrachten schrijven accountgerelateerde nummer- en prijscache-items en querylogs bij. Een zoekopdracht herhalen is geen reservering, prijsgrendel of aankoop.
- De geretourneerde prijzen, voorwaarden, beperkingen en mogelijkheden moeten worden beoordeeld voor het geselecteerde account en nummer. Een featurelabel stelt geen activering, messaging-goedkeuring of geteste functionaliteit vast.