Abdeckung durch die Zuteilungstabelle prüfen
Prüfen Sie, ob eine nordamerikanische Rufnummer mit einem Präfix in der Zuteilungstabelle von MultiTEL übereinstimmt, und rufen Sie die zugehörige Stadt, den Bundesstaat und das Land ab. Dabei wird eine Präfixtabelle abgefragt. Daraus lässt sich nicht ableiten, dass ein Teilnehmeranschluss aktiv ist, dass die Rufnummer vergeben ist, dass sie zu Ihrem Konto gehört oder dass Sie sie bestellen können.
Anfrage
Verwenden Sie Ihr freigeschaltetes API-Konto und eine zugelassene Quell-IP-Adresse. Das Beispiel verwendet Zugangsdaten für HTTP Basic aus Umgebungsvariablen und eine fiktive Rufnummer. Ein Anfragekörper ist nicht erforderlich.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/nanpacheck/12025550123Verwenden Sie vorzugsweise eine elfstellige nordamerikanische Rufnummer, die mit 1 beginnt. Die Verarbeitungsroutine entfernt alle Zeichen außer Ziffern und stellt einer zehnstelligen Eingabe eine 1 voran. Andere Ziffernanzahlen werden abgelehnt. Diese Normalisierung prüft nicht alle nordamerikanischen Nummerierungsregeln; daher stellt eine erfolgreiche Übereinstimmung mit der Tabelle keine umfassende Rufnummernprüfung dar.
Antwort
Die Feldwerte dienen ausschließlich der Veranschaulichung; sie sind kein Ergebnis einer aktuellen Abfrage der Zuteilungstabelle.
{
"status": {
"code": 200,
"msg": "12025550123"
},
"response": {
"number": "12025550123",
"npanxx": "1202555",
"city": "Example City",
"state": "DC",
"country": "US"
}
}| Feld | Bedeutung |
|---|---|
| number | Normalisierte Eingabe, die ausschließlich Ziffern enthält. |
| npanxx | Das übereinstimmende gespeicherte Präfix. Die Verarbeitungsroutine bevorzugt ein siebenstelliges Präfix aus Landeskennzahl, Ortsnetzkennzahl und Vermittlungsstellenkennzahl und kann ersatzweise ein vierstelliges Präfix aus Landeskennzahl und Ortsnetzkennzahl verwenden; gehen Sie nicht davon aus, dass dieses Feld immer eine vollständige Vermittlungsstellenkennzahl enthält. |
| city, state, country | Metadaten zum übereinstimmenden Zuteilungspräfix. Diese Felder geben weder den aktuellen physischen Standort eines Teilnehmers noch dessen aktuellen Anbieter nach einer Rufnummernportierung an. |
Fehler
Lesen Sie das Feld status.code in der JSON-Antwort, statt sich allein auf HTTP 200 zu verlassen. Der API-Code 404 mit der Meldung Not part of NANPA bedeutet, dass kein Präfix mit der vom Dienst verwendeten Tabelle übereinstimmt; dies ist keine abschließende Feststellung einer weltweit zuständigen Nummerierungsbehörde. Der API-Code 500 wird bei einer ungültigen Ziffernanzahl oder einer fehlenden Rufnummer verwendet.
Kosten und nächste Schritte
Die geprüfte Verarbeitungsroutine fragt eine lokale Zuteilungstabelle ab und enthält weder eine Kontobelastung noch eine externe Abfrage. Diese Verarbeitungsroutine erhebt keine Abfragegebühr. Verwenden Sie die Suche nach verfügbaren Rufnummern, um bestellbare Rufnummernbestände zu finden. Eine Namensabfrage, eine Routing-Abfrage oder eine Rufnummernbestellung ist jeweils ein anderer Vorgang, für den die eigenen Preise Ihres Kontos gelten.