Sprawdź zakres przydziałów numeracji północnoamerykańskiej

Sprawdź, czy numer jest objęty tabelą przydziałów

Sprawdź, czy numer północnoamerykański pasuje do prefiksu w tabeli przydziałów MultiTEL, i pobierz powiązane miasto, stan i kraj. Jest to wyszukiwanie w tabeli prefiksów. Nie potwierdza ono, że abonent jest aktywny, że numer został przydzielony, że należy do Twojego konta ani że możesz go zamówić.

Żądanie

Użyj aktywnego konta API i dozwolonego źródłowego adresu IP. Przykład wykorzystuje dane uwierzytelniające HTTP Basic ze zmiennych środowiskowych oraz fikcyjny numer. Treść żądania nie jest wymagana.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/nanpacheck/12025550123

Najlepiej użyć jedenastocyfrowego numeru północnoamerykańskiego zaczynającego się od 1. Kod obsługujący żądanie usuwa znaki niebędące cyframi i dodaje 1 na początku dziesięciocyfrowych danych wejściowych. Inne liczby cyfr są odrzucane. Ta normalizacja nie sprawdza wszystkich zasad numeracji północnoamerykańskiej, dlatego znalezienie dopasowania w tabeli nie stanowi pełnej weryfikacji numeru.

Odpowiedź

Wartości pól służą wyłącznie jako przykład; nie jest to wynik uzyskany z aktualnej tabeli przydziałów.

{
  "status": {
    "code": 200,
    "msg": "12025550123"
  },
  "response": {
    "number": "12025550123",
    "npanxx": "1202555",
    "city": "Example City",
    "state": "DC",
    "country": "US"
  }
}

Pola dopasowania przydziału
Pole	Znaczenie
number	Znormalizowane dane wejściowe zawierające wyłącznie cyfry.
npanxx	Pasujący prefiks zapisany w tabeli. Kod obsługujący żądanie w pierwszej kolejności szuka siedmiocyfrowego prefiksu obejmującego kod kraju, strefy i centrali, a w razie braku dopasowania może użyć czterocyfrowego prefiksu kraju i strefy; nie należy zakładać, że to pole zawsze wskazuje pełny prefiks centrali.
city, state, country	Metadane dopasowanego prefiksu przydziału. Pola te nie wskazują aktualnej fizycznej lokalizacji abonenta ani obecnego operatora po przeniesieniu numeru.

Błędy

Odczytuj z odpowiedzi JSON pole status.code, zamiast polegać wyłącznie na kodzie HTTP 200. Kod API 404 z komunikatem Not part of NANPA oznacza, że nie znaleziono pasującego prefiksu w tabeli używanej przez usługę; nie jest to ostateczne rozstrzygnięcie organu odpowiedzialnego za numerację w skali światowej. Kod API 500 jest używany w przypadku nieprawidłowej liczby cyfr lub braku numeru.

Koszty i dalsze kroki

Przeanalizowany kod obsługujący żądanie wykonuje zapytanie do lokalnej tabeli przydziałów i nie obciąża konta ani nie przeprowadza wyszukiwania w zewnętrznych źródłach. Ten kod nie nalicza opłaty za wyszukiwanie. Skorzystaj z funkcji wyszukiwania dostępnych numerów, aby znaleźć numery dostępne do zamówienia. Wyszukiwanie nazwy, sprawdzanie routingu lub zamówienie numeru to odrębne operacje, dla których obowiązują osobne stawki przypisane do konta.