Hitta tillgängliga mobilnummer

Bekräfta att mobilt lager är aktiverat

Använd denna sökning först efter att mobilnummerlager har aktiverats för ditt kundkonto. Hämta ett aktuellt individuellt mobilprefix via kontots discovery-arbetsflöde. Den stödda sökvägen begär trådlöst lager för det prefixet. Den är inte beroende av en matchande routingmetadatapost för fast linje. Kontakta supporten om du är osäker på om ditt konto eller prefix är aktiverat.

Den nuvarande äldre rutten avvisar inte pålitligt varje begäran som inte är berättigad. Ett konto utan aktiverat mobilt lager kan få vanligt lager medan svaret fortfarande säger info.is_mobile: 1. Ett avgiftsfritt prefix kan också nå grenen för avgiftsfritt lager med den etiketten. Använd inte denna etikett ensam för att identifiera mobiltjänst, och skicka inte vanliga eller avgiftsfria prefix till denna slutpunkt. Använd kontots bekräftade mobilkatalog och aktiverade arbetsflöde.

Behåll varje nummer tillsammans med sitt eget prisval

Behåll för varje kandidat number, info.uuid och samma posts price-lista tillsammans. Svaret innehåller även metadata för prefix/område/land, kontraktsvillkor och registreringsbegränsningar. Kandidaterna sorteras efter månadspriset för sitt första prisval, stigande; det finns ingen garanterad stabil ordning för lika priser. Ersätt inte det returnerade nummer-ID:t med ett områdes- eller prefix-ID, och para inte ihop det med en annan kandidats pris-ID.

Det fullständiga svaret kan innehålla ytterligare metadata- och prisfält. Returnerade features, kanalvärden och restrictions beskriver kandidaten; de är ingen garanti för att samtal, SMS, MMS eller fax redan är användbara. Kontobehörigheter, registrering och det valda tjänsteabonnemanget gäller fortfarande. Behandla inte exemplets platshållare som giltiga ID:n eller priser.

Använd en liten positiv kvantitet

Börja med en kvantitet på 1. Den normala leverantörsbegäran normaliserar en icke-positiv kvantitet till 1 och begränsar uppströmsvärdet till 300, men senare resultathantering använder fortfarande den ursprungliga inmatningen. En kvantitet på noll kan därför begära uppströmslager och returnera inga kandidater. Andra äldre grenar genomdriver inte konsekvent det begärda resultatantalet. Lita inte på ett enda universellt maximum, och skicka inte negativa, fraktionella eller icke-numeriska värden. Inget stött offentligt sökfilter eller pris-ID-brödtextparameter är dokumenterat för denna rutt.

Skilj mellan saknat lager och uppslagsfel

Ett 404-svar kan representera otillgängligt lager, inaktiverad tjänst, misslyckat leverantörsuppslag eller ogiltiga katalogposter. Behandla en timeout eller ett leverantörsfel som okänd tillgänglighet i stället för bekräftat nollager. Uppdatera urvalet och försök igen med backoff när det är lämpligt. Undvik att polla varje växel upprepade gånger. Den separata slutpunkten för mobilt lagerantal är en ögonblicksbildshint och behöver inte motsvara längden på detta kontos kandidatlista.

Kontrollera igen före köp

Sökning reserverar inte lager. Den granskade grenen försöker utesluta nummer som redan har köpts, men ett misslyckat lokalt reservationsuppslag kan lämna en sådan kandidat kvar i resultatet. Tillgänglighet, ägarskap, godkänd prissättning och registrering måste kontrolleras av köparbetsflödet. Använd ett färskt urval med den skyddade köpbegäran, och stäm av kontolagret efter ett osäkert köpresultat innan du försöker igen. Köp aldrig enbart för att en kandidat returnerades.

Begäran

Använd ett aktiverat API-konto över HTTPS från en tillåten käll-IP-adress. Mobilt lager måste också vara aktiverat för kundkontot; API-autentisering ensam aktiverar det inte.

GET med den aktuella individuella prefixidentifieraren och en positiv heltalskvantitet i URL-sökvägen. Kvantiteten är standard 1 om den utelämnas. Använd exemplet med 1; denna rutt validerar eller genomdriver inte konsekvent en universell resultatgräns.

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

Svar

Inspektera status.code och status.msg i JSON-kroppen samt HTTP-status. Vid framgång är response en lista med nummerkandidater, status.msg är Results: följt av antalet returnerade, och status.results är den serialiserade listlängden. Kandidatpriser är kontospecifika. Det illustrativa förkortade exemplet använder platshållare i stället för verkligt lager eller en tariffnotering. Nummer innehåller landskoden utan plusstecken; identifierare är ogenomskinliga strängar.

Illustrativ svarform; inte faktiska kontodata eller en aktuell notering.

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

Fel

• 404: Ogiltigt prefix-ID, land eller område: uppdatera urvalet av individuella mobilprefix.
• 404: Inga nummer hittade: kan betyda inget användbart lager, inaktiverad tjänst, misslyckat leverantörsuppslag, ostött urval eller kontobegränsningar. Det är inget bevis på ett auktoritativt lagerantal på noll.

Tillgänglighet och biverkningar

• Sökning hyr eller reserverar inte ett nummer, och den granskade sökvägen debiterar inte ett köpbelopp. Den kontaktar lagerleverantören och kan ta tid.
• Framgångsrika sökningar skriver kontorelaterade nummer- och priscacheposter och frågeloggar. Att upprepa en sökning är inte en reservation, prislås eller köp.
• De returnerade priserna, villkoren, begränsningarna och funktionerna måste granskas för det valda kontot och numret. En funktionsetikett fastställer inte aktivering, meddelandegodkännande eller testad tjänstefunktionalitet.