Sprawdzanie informacji o routingu

Pobierz informacje o routingu dla północnoamerykańskiego numeru telefonu. Używaj ich do interpretowania dostępnych danych o routingu i operatorze, a nie jako dowodu tożsamości abonenta, własności numeru, możliwości dodzwonienia się na niego ani jego dostępności do zakupu. Zapytanie może spowodować obciążenie konta.

Żądanie

Użyj swojego aktywnego konta API oraz dozwolonego dla niego źródłowego adresu IP. Podaj pełny numer w postaci cyfr, łącznie z kodem kraju 1. Przykład wykorzystuje zmienne środowiskowe i fikcyjny numer. Procedura obsługi nie normalizuje znaków interpunkcyjnych; sprawdź poprawność danych wejściowych przed ich wysłaniem.

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

Odpowiedź

Pokazano jedynie wybrane pola jako przykład; ich dostępność zależy od źródła i typu numeru.

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": {
    "lrn": "12025550123",
    "ocn": "0000",
    "local": 1,
    "ported": 0,
    "cost": "$0.00025"
  }
}

Standardowe zapytanie zamienia nazwy zwracanych pól na małe litery. W zależności od źródła mogą występować pola dotyczące operatora, obszaru taryfowego, lokalizacji i obszaru jurysdykcji. Odpowiedź nie jest kompletnym rekordem abonenta o stałej strukturze. Znacznik local może mieć wartość liczbową 1 lub wartość 0 w postaci ciągu znaków. Procedura obsługi wylicza ported, porównując zwrócony numer routingu z podanym numerem telefonu; nie traktuj tej wartości jako zweryfikowanej, pełnej historii przenoszenia numeru.

Cena i ponawianie żądań

Sprawdzona procedura obsługi obciąża konto kwotą $0.00025, gdy osiągnie ścieżkę zakończenia i zapisze zapytanie. Zwracany koszt ma zwykle postać ciągu znaków zawierającego symbol dolara, a nie samej wartości liczbowej. Nie jest udostępniany klucz idempotencji. Powtórzenie żądania może spowodować naliczenie kolejnej opłaty.

W przypadku kont przedpłaconych kod sprawdza, czy saldo wynosi co najmniej 0.00025. Komunikat o niewystarczającym saldzie podaje obecnie kwotę $5, która nie odpowiada temu progowi. Traktuj ten błąd jako odrzucenie z powodu salda i przed ponowieniem żądania upewnij się, że na koncie są wystarczające środki.

Błędy i częściowo udane zapytania

Sprawdzaj zarówno status HTTP, jak i status.code/status.msg w JSON. Pusty wynik standardowego zapytania zwraca kod API 404. Kod API 403 może oznaczać niewystarczające saldo konta przedpłaconego.

Obecna ścieżka błędu dla numerów bezpłatnych może mimo błędu pobrać opłatę za zapytanie i zgłosić kod API 200 bez użytecznych pól routingu; informacja o koszcie może być niepełna. Sam kod 200 nie potwierdza więc, że uzyskano użyteczny wynik zapytania. Sprawdzaj poprawność pól wymaganych przez aplikację, porównuj niejasne opłaty z dokumentacją rozliczeniową konta i kontaktuj się z pomocą techniczną w przypadku niepełnych wyników.

W sprawdzonej implementacji obsługa numerów bezpłatnych różni się w zależności od długości danych wejściowych. Preferuj pełny międzynarodowy zapis numeru w postaci cyfr i potwierdź z pomocą techniczną, czy wymagane numery bezpłatne są obsługiwane. Nie ponawiaj automatycznie zapytania po otrzymaniu niepoprawnie sformatowanego lub niepełnego wyniku i nie polegaj na sprawdzeniu routingu przy ustalaniu, czy połączenie z danym numerem jest bezpieczne lub dozwolone.