Find tilgængelige mobilnumre

Bekræft at mobilbeholdning er aktiveret

Brug denne søgning først efter at mobilnummerbeholdning er blevet aktiveret for din kundekonto. Hent et aktuelt individuelt mobilpræfiks gennem kontoens discovery-arbejdsgang. Den understøttede sti anmoder om trådløs beholdning for det præfiks. Den afhænger ikke af en matchende wireline-routingmetadata-post. Kontakt support, hvis du er usikker på, om din konto eller præfiks er aktiveret.

Den nuværende legacy-rute afviser ikke alle uberettigede anmodninger pålideligt. En konto uden aktiveret mobilbeholdning kan modtage almindelig beholdning, mens svaret stadig siger info.is_mobile: 1. Et toll-free-præfiks kan også nå toll-free-beholdningsgrenen med den etiket. Brug ikke denne etiket alene til at identificere mobilservice, og send ikke almindelige eller toll-free-præfikser til dette endpoint. Brug kontoens bekræftede mobilkatalog og aktiverede arbejdsgang.

Bevar hvert nummer med dets eget prisvalg

Bevar for hver kandidat number, info.uuid og den samme posts price-liste sammen. Svaret indeholder også præfiks/område/land-metadata, kontraktvilkår og registreringsbegrænsninger. Kandidater sorteres efter månedsprisen på deres første prisvalg, stigende; der er ingen garanteret stabil rækkefølge for ens priser. Erstat ikke det returnerede nummer-ID med et område- eller præfiks-ID, og par det ikke med en anden kandidats pris-ID.

Det fulde svar kan indeholde yderligere metadata- og prisfelter. Returnerede features, kanalværdier og restrictions beskriver kandidaten; de er ikke en garanti for, at opkald, sms, mms eller fax allerede er brugbare. Kontotilladelser, registrering og den valgte serviceplan gælder stadig. Betragt ikke eksemplets pladsholdere som gyldige id'er eller priser.

Brug et lille positivt antal

Begynd med et antal på 1. Den normale udbyderanmodning normaliserer et ikke-positivt antal til 1 og begrænser upstream-værdien til 300, men senere resulthåndtering bruger stadig det oprindelige input. Et nul-antal kan derfor anmode om upstream-beholdning og returnere ingen kandidater. Andre legacy-grene håndhæver ikke konsekvent det anmodede resultatantal. Stol ikke på ét universelt maksimum, og send ikke negative, brøk- eller ikke-numeriske værdier. Der er ingen dokumenteret understøttet offentlig søgefilter- eller pris-ID-bodyparameter for denne rute.

Skeln mellem manglende beholdning og opslagsfejl

Et 404-svar kan repræsentere utilgængelig beholdning, deaktiveret service, mislykket leverandøropslag eller ugyldige katalogposter. Behandl en timeout eller udbyderfejl som ukendt tilgængelighed frem for bekræftet nul-beholdning. Opdater udvalget og prøv igen med backoff, hvor det er passende. Undgå at forespørge hver telefoncentral gentagne gange. Det separate endpoint for antal mobilnumre er et øjebliksbillede-hint og behøver ikke at matche længden af denne kontos kandidatliste.

Tjek igen før køb

Søgning reserverer ikke beholdning. Den gennemgåede gren forsøger at udelukke allerede købte numre, men et mislykket lokalt reservationsopslag kan efterlade en sådan kandidat i resultatet. Tilgængelighed, ejerskab, godkendte priser og registrering skal kontrolleres af købsarbejdsgangen. Brug et frisk udvalg med den beskyttede købsanmodning og afstem kontobeholdningen efter ethvert usikkert købsresultat, før du prøver igen. Køb aldrig blot fordi en kandidat blev returneret.

Anmodning

Brug en aktiveret API-konto over HTTPS fra en tilladt kilde-IP-adresse. Mobilbeholdning skal også være aktiveret for kundekontoen; API-autentificering alene aktiverer den ikke.

GET med den aktuelle individuelle præfiks-id og et positivt heltal som antal i URL-stien. Antal er som standard 1, hvis det udelades. Brug eksemplet med 1; denne rute validerer eller håndhæver ikke konsekvent en universel resultatgrænse.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/getmobiles/$PREFIX_ID/1"

Svar

Inspectér status.code og status.msg i JSON-bodyen samt HTTP-status. Ved succes er response en liste over nummerkandidater, er status.msg Results: efterfulgt af det returnerede antal, og er status.results den serialiserede listelængde. Kandidatpriser er kontospecifikke. Det illustrative forkortede eksempel bruger pladsholdere i stedet for reel beholdning eller et tariftilbud. Numre indeholder landekoden uden et plustegn; id'er er uigennemsigtige strenge.

Illustrativ svarform; ikke live kontodata eller et aktuelt tilbud.

{
  "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"
      ]
    }
  ]
}

Fejl

• 404: Ugyldigt præfiks-ID, land eller område: opdater udvalget af det individuelle mobilpræfiks.
• 404: Ingen numre fundet: kan betyde ingen brugbar beholdning, deaktiveret service, mislykket udbyderopslag, ikke-understøttet udvalg eller kontobegrænsninger. Det er ikke bevis på en autoritativ nul-beholdningsoptælling.

Tilgængelighed og bivirkninger

• Søgning lejer eller reserverer ikke et nummer, og den gennemgåede sti trækker ikke et købsbeløb. Den kontakter beholdningsudbyderen og kan tage tid.
• Vellykkede søgninger skriver kontorelaterede nummer- og priscache-poster og forespørgselslogs. At gentage en søgning er ikke en reservation, prislåsning eller et køb.
• De returnerede priser, vilkår, begrænsninger og muligheder skal gennemgås for den valgte konto og nummer. En funktionsmærkat etablerer ikke aktivering, messaging-godkendelse eller testet funktionalitet.