Vind beskikbare mobiele nommers

Bevestig dat mobiele voorraad geaktiveer is

Gebruik hierdie soektog slegs nadat mobiele-nommer-voorraad vir jou klantrekening geaktiveer is. Verkry 'n huidige individuele mobiele voorvoegsel deur die rekening se ontdekkingswerkvloei. Die ondersteunde pad versoek draadlose voorraad vir daardie voorvoegsel. Dit is nie afhanklik van 'n ooreenstemmende vastelyn-roeteringsmetadata-rekord nie. Kontak ondersteuning as jy onseker is of jou rekening of voorvoegsel geaktiveer is.

Die huidige verouderde roete verwerp nie elke ongeskikte versoek betroubaar nie. 'n Rekening sonder geaktiveerde mobiele voorraad kan gewone voorraad ontvang terwyl die antwoord steeds die volgende sê: info.is_mobile: 1. 'n Tolvrye voorvoegsel kan ook met daardie etiket die tolvrye voorraadtak bereik. Moenie hierdie etiket alleen gebruik om mobiele diens te identifiseer nie, en moenie gewone of tolvrye voorvoegsels na hierdie eindpunt stuur nie. Gebruik die rekening se bevestigde mobiele katalogus en geaktiveerde werkvloei.

Hou elke nommer by sy eie pryskeuse

Hou vir elke kandidaat number, info.uuid en dieselfde inskrywing se price lys bymekaar. Die antwoord bevat ook voorvoegsel-/area-/landmetadata, kontrakvoorwaardes en registrasiebeperkings. Kandidate word gesorteer volgens die maandelikse prys van hul eerste prysopsie, stygend; daar is geen gewaarborgde stabiele volgorde vir gelyke pryse nie. Moenie die teruggestuurde nommer-ID met 'n area- of voorvoegsel-ID vervang nie, en moet dit ook nie met 'n ander kandidaat se prys-ID paar nie.

Die volledige antwoord kan bykomende metadata- en prysvelde insluit. Teruggestuurde features, kanaalwaardes en restrictions beskryf die kandidaat; hulle is nie 'n waarborg dat oproepe, SMS, MMS of faks reeds bruikbaar is nie. Rekeningtoestemmings, registrasie en die gekose diensplan geld steeds. Moenie die voorbeeld se plekhouers as geldige ID's of pryse beskou nie.

Gebruik 'n klein positiewe hoeveelheid

Begin met 'n hoeveelheid van 1. Die normale verskafferversoek normaliseer 'n nie-positiewe hoeveelheid na 1 en beperk die stroomop-waarde tot 300, maar die latere resultaathantering gebruik steeds die oorspronklike invoer. 'n Hoeveelheid van nul kan dus stroomop-voorraad versoek en geen kandidate terugstuur nie. Ander verouderde takke dwing die versoekte resultaattelling nie konsekwent af nie. Moenie op 'n enkele universele maksimum staatmaak nie, en moenie negatiewe, breuk- of nie-numeriese waardes stuur nie. Geen ondersteunde publieke soekfilter of prys-ID-liggaamparameter word vir hierdie roete gedokumenteer nie.

Onderskei ontbrekende voorraad van opsoekfout

'n 404-antwoord kan onbeskikbare voorraad, gedeaktiveerde diens, 'n mislukte leweransieropsoek of ongeldige katalogusrekords verteenwoordig. Behandel 'n tyduitloop of verskafferfout as onbekende beskikbaarheid eerder as bevestigde nul voorraad. Verfris die keuse en probeer weer met ’n wagtyd tussen pogings (backoff) waar toepaslik. Vermy herhaalde navraag van elke sentrale. Die afsonderlike mobiele voorraadtelling-eindpunt is 'n momentopname-wenk en hoef nie met die lengte van hierdie rekening se kandidaatlys ooreen te stem nie.

Kontroleer weer voordat jy koop

Soektog reserveer nie voorraad nie. Die hersiende tak probeer om reeds gekoopte nommers uit te sluit, maar 'n mislukte plaaslike reserveringsopsoek kan so 'n kandidaat in die resultaat laat. Beskikbaarheid, eienaarskap, goedgekeurde prysbepaling en registrasie moet deur die aankoopwerkvloei nagegaan word. Gebruik 'n vars keuse met die beskermde aankoopversoek, en versoen die rekeningvoorraad ná enige onsekere aankoopresultaat voordat jy weer probeer. Moet nooit koop bloot omdat 'n kandidaat teruggestuur is nie.

Versoek

Gebruik 'n geaktiveerde API-rekening oor HTTPS vanaf 'n toegelate bron-IP-adres. Mobiele voorraad moet ook vir die klantrekening geaktiveer wees; API-outentisering alleen aktiveer dit nie.

GET met die huidige individuele voorvoegsel-identifiseerder en 'n positiewe heelgetal-hoeveelheid in die URL-pad. Hoeveelheid is by verstek 1 indien weggelaat. Gebruik die voorbeeld met 1; hierdie roete valideer of dwing nie konsekwent 'n universele resultaatlimiet af nie.

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

Antwoord

Inspekteer status.code en status.msg in die JSON-liggaam sowel as die HTTP-status. By sukses is response 'n lys van nommerkandidate, status.msg is Results: gevolg deur die aantal wat teruggestuur is, en status.results is die geserialiseerde lyslengte. Kandidaatpryse is rekeningspesifiek. Die illustratiewe verkorte voorbeeld gebruik plekhouers in plaas van werklike voorraad of 'n tariefkwotasie. Nommers bevat die landkode sonder 'n plusteken; identifiseerders is ondeursigtige stringe.

Illustratiewe antwoordvorm; nie lewendige rekeningdata of 'n huidige kwotasie nie.

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

Foute

• 404: Ongeldige voorvoegsel-ID, land of area: verfris die individuele mobiele voorvoegselkeuse.
• 404: Geen nommers gevind nie: kan beteken geen bruikbare voorraad, gedeaktiveerde diens, mislukte verskafferopsoek, onondersteunde keuse of rekeningbeperkings. Dit is nie bewys van 'n gesaghebbende voorraadtelling van nul nie.

Beskikbaarheid en newe-effekte

• Soektog huur of reserveer nie 'n nommer nie, en die hersiende pad debiteer nie 'n aankoopbedrag nie. Dit kontak die voorraadverskaffer en kan tyd neem.
• Suksesvolle soektogte skryf rekeningverwante kasgeheue-inskrywings vir nommers en pryse en navraaglogboeke. Die herhaling van 'n soektog is nie 'n reservering, prysvergrendeling of aankoop nie.
• Die teruggestuurde pryse, voorwaardes, beperkings en vermoëns moet vir die gekose rekening en nommer hersien word. 'n Kenmerk-etiket bevestig nie aktivering, boodskapgoedkeuring of getoetste diensfunksionaliteit nie.