Välj ett prefix som stöds
Använd ett aktuellt individuellt mobilprefix från discovery. Detta endpoint är avsett för NANPA-växlar: en NPA identifierar riktnumret, och en NXX identifierar växeln. Ett prefix med endast riktnummer är för brett. Skicka inte grupperade visnings-ID:n, och dra inte slutsatsen att ett annat land stöds bara för att dess prefix innehåller tillräckligt många siffror.
Använd antalet som en hint
Läs response.count, med response.npa och response.nxx som identifierar växeln. Detta är täckningstjänstens ögonblicksbild, inte lager som hålls för ditt konto. Bekräfta faktiska nummer, tillämpliga prisofferter och eventuella registreringskrav innan du beställer. Ett lyckat antal ger aldrig behörighet till ett köp.
Skilj på tomt lager och ett misslyckat uppslag
Ett lyckat antal på noll skiljer sig från ett API-fel. Inspektera status.code och status.msg samt HTTP-statusen. Behandla en timeout eller ett misslyckat uppslag som okänd tillgänglighet och försök igen senare med backoff.
Begäran
Använd dina aktiverade API-kontouppgifter över HTTPS. Basic-autentisering och bearer-token för aktiverade API-konton stöds; kontobegränsningar gäller.
GET med prefixidentifieraren i URL-sökvägen. Det finns inga dokumenterade fråge- eller kroppsparametrar.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getmobilecount/$PREFIX_ID"| Namn | Typ | Obligatorisk | Beskrivning |
|---|---|---|---|
prefix_id | string | Ja | Kopiera det individuella prefix-ID:t från discovery-svaret. Använd ett NANPA-mobilprefix som stöds och som innehåller ett riktnummer (NPA) och en växel (NXX), inte enbart ett riktnummer eller ett grupperat sammanfattnings-ID. Behandla identifieraren som opak. |
Svar
Kontrollera status.code i JSON-kroppen samt HTTP-statusen. Ett lyckat response har status.code 200 och status.msg Results. response är ett objekt, inte en lista: count är en heltalsögonblicksbild av lagret; npa och nxx är teckensträngar på tre tecken. status.results finns inte för detta associativa objekt. Ett antal på 0 betyder att täckningsuppslaget inte hade någon matchande växel eller returnerade tomt lager; det bevisar inte att alla leverantörer eller andra discovery-rutter saknar nummer.
Illustrativt svarsformat; inte levande kontodata eller en aktuell prisoffert.
{
"status": {
"code": 200,
"msg": "Results"
},
"response": {
"count": 42,
"npa": "212",
"nxx": "555"
}
}Fel
- 404: Leverantör inaktiverad: mobil lagertäckning är inte tillgänglig på tjänsten.
- 404: Ogiltigt prefix-ID: skaffa ett aktuellt individuellt prefix-ID från discovery.
- 404: Ogiltigt prefix: det lagrade prefixet innehåller inte tillräckligt många siffror för ett NPA/NXX-uppslag.
- 500: Lagertäckning misslyckades: uppslaget uppströms returnerade inte ett lyckat täckningsresultat. Försök igen senare med backoff; ett fel är inte ett lagerantal på noll.
Tillgänglighet och bieffekter
- Operationen kontrollerar lagret och lägger inte en beställning, reserverar inte nummer och debiterar inte något köpbelopp.
- Lagret kan ändras omedelbart. Täckningsantalet är inte justerat för att lova kontospecifik köpbarhet eller samma längd som svaret från nästa nummersökning.
- Ett uppslag kontaktar täckningstjänsten och kan ta tid. Polla inte varje prefix upprepade gånger, och behandla inte en timeout eller ett fel som lyckat tomt lager.