Wybierz obsługiwany prefiks
Użyj bieżącego indywidualnego prefiksu komórkowego z wyszukiwania. Ten punkt końcowy jest przeznaczony dla central NANPA: NPA identyfikuje numer kierunkowy, a NXX identyfikuje centralę. Prefiks składający się tylko z numeru kierunkowego jest zbyt ogólny. Nie wysyłaj pogrupowanych identyfikatorów wyświetlanych ani nie wnioskuj obsługi innego kraju tylko dlatego, że jego prefiks zawiera wystarczająco dużo cyfr.
Traktuj liczbę jako wskazówkę
Odczytaj response.count, z response.npa i response.nxx identyfikującymi centralę. To jest migawka usługi pokrycia, a nie zapasy trzymane dla Twojego konta. Potwierdź rzeczywiste numery, odpowiednie wyceny i ewentualne wymagania rejestracyjne przed złożeniem zamówienia. Pomyślne zliczenie nigdy nie upoważnia do zakupu.
Odróżnij zerowy stan zapasów od nieudanego wyszukiwania
Pomyślne zliczenie o wartości zero różni się od błędu API. Sprawdź status.code i status.msg a także status HTTP. Traktuj przekroczenie limitu czasu lub nieudane wyszukiwanie jako nieznaną dostępność i ponów próbę później z przerwą między kolejnymi próbami (backoff).
Żądanie
Użyj danych uwierzytelniających swojego włączonego konta API przez HTTPS. Obsługiwane jest uwierzytelnianie Basic oraz tokeny bearer włączonych kont API; obowiązują ograniczenia konta.
GET z identyfikatorem prefiksu w ścieżce URL. Nie ma udokumentowanych parametrów zapytania ani treści żądania.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getmobilecount/$PREFIX_ID"| Nazwa | Typ | Wymagany | Opis |
|---|---|---|---|
prefix_id | string | Tak | Skopiuj indywidualny identyfikator prefiksu z odpowiedzi wyszukiwania. Użyj obsługiwanego komórkowego prefiksu NANPA zawierającego numer kierunkowy (NPA) i centralę (NXX), a nie identyfikatora zawierającego tylko numer kierunkowy ani pogrupowanego identyfikatora podsumowującego. Traktuj identyfikator jako nieprzezroczysty. |
Odpowiedź
Sprawdź status.code w treści JSON oraz status HTTP. Pomyślna response ma status.code 200 i status.msg Results. response jest obiektem, a nie listą: count jest migawką zapasów typu integer; npa i nxx są ciągami trzyznakowymi. status.results nie występuje dla tego obiektu asocjacyjnego. Licznik 0 oznacza, że wyszukiwanie pokrycia nie znalazło pasującej centrali albo zwróciło zerowy stan zapasów; nie dowodzi to, że u wszystkich dostawców lub innych ścieżek wyszukiwania nie ma żadnych numerów.
Ilustracyjny kształt odpowiedzi; nie są to dane konta na żywo ani bieżąca wycena.
{
"status": {
"code": 200,
"msg": "Results"
},
"response": {
"count": 42,
"npa": "212",
"nxx": "555"
}
}Błędy
- 404: Dostawca wyłączony: pokrycie zapasów numerów komórkowych jest niedostępne w usłudze.
- 404: Nieprawidłowy identyfikator prefiksu: uzyskaj bieżący indywidualny identyfikator prefiksu z wyszukiwania.
- 404: Nieprawidłowy prefiks: zapisany prefiks nie zawiera wystarczającej liczby cyfr do wyszukiwania NPA/NXX.
- 500: Niepowodzenie pokrycia zapasów: wyszukiwanie nadrzędne nie zwróciło pomyślnego wyniku pokrycia. Ponów próbę później z przerwą między kolejnymi próbami (backoff); niepowodzenie nie jest liczbą zerowego stanu zapasów.
Dostępność i skutki uboczne
- Operacja sprawdza zapasy i nie składa zamówienia, nie rezerwuje numerów ani nie obciąża kwoty zakupu.
- Zapasy mogą się zmienić natychmiast. Liczba pokrycia nie jest dostosowywana tak, aby obiecywać możliwość zakupu specyficzną dla konta lub tę samą długość co odpowiedź następnego wyszukiwania numerów.
- Wyszukiwanie kontaktuje usługę pokrycia i może zająć trochę czasu. Nie odpytuj wielokrotnie każdego prefiksu ani nie traktuj przekroczenia limitu czasu/błędu jako pomyślnego zerowego stanu zapasów.