Potwierdź, że inwentarz mobilny jest włączony
Korzystaj z tego wyszukiwania dopiero po włączeniu inwentarza numerów mobilnych dla Twojego konta klienta. Uzyskaj bieżący indywidualny prefiks mobilny za pośrednictwem przepływu pracy odkrywania konta. Obsługiwana ścieżka żąda inwentarza bezprzewodowego dla tego prefiksu. Nie zależy ona od pasującego rekordu metadanych trasowania sieci stacjonarnej. Skontaktuj się z pomocą techniczną, jeśli nie masz pewności, czy Twoje konto lub prefiks jest włączony.
Bieżąca trasa starszej wersji nie odrzuca niezawodnie wszystkich niekwalifikujących się żądań. Konto bez włączonego inwentarza mobilnego może otrzymać zwykły inwentarz, mimo że odpowiedź nadal przedstawia etykietę info.is_mobile: 1. Prefiks bezpłatny może również trafić do gałęzi inwentarza bezpłatnego z tą etykietą. Nie używaj samej tej etykiety do identyfikacji usługi mobilnej i nie wysyłaj do tego punktu końcowego prefiksów zwykłych ani bezpłatnych. Korzystaj z potwierdzonego katalogu mobilnego konta i włączonego przepływu pracy.
Zachowaj każdy numer wraz z jego własnym wyborem ceny
Dla każdego kandydata zachowaj number wspólnie z info.uuid oraz z listą price tego samego wpisu. Odpowiedź zawiera również metadane prefiksu/obszaru/kraju, warunki umowy i ograniczenia rejestracyjne. Kandydaci są sortowani rosnąco według ceny miesięcznej pierwszej opcji cenowej; nie ma zagwarantowanej stabilnej kolejności dla równych cen. Nie zastępuj zwróconego identyfikatora numeru identyfikatorem obszaru ani prefiksu ani nie łącz go z identyfikatorem ceny innego kandydata.
Pełna odpowiedź może zawierać dodatkowe pola metadanych i cen. Zwrócone features, wartości kanałów i restrictions opisują kandydata; nie stanowią gwarancji, że połączenia, SMS-y, MMS-y lub faksy są już użyteczne. Uprawnienia konta, rejestracja i wybrany plan usługi nadal obowiązują. Nie traktuj symboli zastępczych z przykładu jako prawidłowych identyfikatorów ani cen.
Użyj małej dodatniej liczby
Zacznij od liczby 1. Normalne żądanie do dostawcy normalizuje liczbę niedodatnią do 1 i ogranicza wartość nadrzędną do 300, ale późniejsza obsługa wyników nadal używa oryginalnego wejścia. Liczba zerowa może zatem zażądać nadrzędnego inwentarza i nie zwrócić żadnych kandydatów. Inne gałęzie starszej wersji nie egzekwują konsekwentnie żądanej liczby wyników. Nie polegaj na jednym uniwersalnym maksimum ani nie wysyłaj wartości ujemnych, ułamkowych ani niebędących liczbami. Dla tej trasy nie jest udokumentowany żaden obsługiwany publiczny filtr wyszukiwania ani parametr ciała z identyfikatorem ceny.
Odróżnij brak zapasów od niepowodzenia wyszukiwania
Odpowiedź 404 może oznaczać niedostępny inwentarz, wyłączoną usługę, nieudane wyszukanie u dostawcy lub nieprawidłowe rekordy katalogu. Traktuj przekroczenie limitu czasu lub awarię dostawcy jako nieznaną dostępność, a nie potwierdzony zerowy stan zapasów. W razie potrzeby odśwież wybór i ponów próbę z przerwą między kolejnymi próbami (backoff). Unikaj wielokrotnego odpytywania każdej centrali. Osobny punkt końcowy liczby inwentarza mobilnego jest wskazówką migawki i nie musi odpowiadać długości listy kandydatów tego konta.
Sprawdź ponownie przed zakupem
Wyszukiwanie nie rezerwuje zapasów. Przeanalizowana gałąź próbuje wykluczyć numery już wykupione, ale nieudane lokalne wyszukanie rezerwacji może pozostawić takiego kandydata w wyniku. Dostępność, własność, zatwierdzone ceny i rejestrację musi weryfikować przepływ pracy zakupu. Użyj świeżego wyboru z żądaniem zakupu z zabezpieczeniem i uzgodnij inwentarz konta po każdym niepewnym wyniku zakupu przed ponowną próbą. Nigdy nie dokonuj zakupu wyłącznie dlatego, że kandydat został zwrócony.
Zapytanie
Użyj włączonego konta API przez HTTPS z dozwolonego źródłowego adresu IP. Inwentarz mobilny musi być również włączony dla konta klienta; samo uwierzytelnianie API go nie włącza.
GET z bieżącym identyfikatorem indywidualnego prefiksu oraz dodatnią liczbą całkowitą w ścieżce URL. Liczba domyślnie przyjmuje wartość 1, jeśli zostanie pominięta. Użyj przykładu z wartością 1; ta trasa nie weryfikuje ani nie egzekwuje konsekwentnie uniwersalnego limitu wyników.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getmobiles/$PREFIX_ID/1"| Nazwa | Typ | Wymagany | Opis |
|---|---|---|---|
prefix_id | string | Tak | Nieprzezroczysty widoczny identyfikator kwalifikującego się indywidualnego prefiksu mobilnego z odkrywania. Użyj prefiksu centrali mobilnej NPA/NXX obsługiwanego przez Twoje konto; nie podstawiaj identyfikatora obszaru, zgrupowanego identyfikatora wyświetlanego, dosłownego prefiksu wybierania ani prefiksu bezpłatnego. |
quantity | integer | Nie | Żądana liczba kandydatów. Domyślnie 1. Podaj umiarkowaną dodatnią liczbę całkowitą. Normalne żądanie nadrzędne ogranicza swoją liczbę do 300, ale nie jest to uniwersalnie walidowane wejście ani gwarancja rozmiaru odpowiedzi. |
Odpowiedź
Sprawdź status.code i status.msg w ciele JSON oraz status HTTP. Po sukcesie response jest listą kandydatów na numery, status.msg ma wartość Results:, po której następuje liczba zwróconych pozycji, a status.results reprezentuje zserializowaną długość listy. Ceny kandydatów są specyficzne dla konta. Ilustracyjny skrócony przykład używa symboli zastępczych zamiast rzeczywistego inwentarza lub wyceny taryfowej. Numery zawierają kod kraju bez znaku plus; identyfikatory są nieprzezroczystymi ciągami.
Ilustracyjny kształt odpowiedzi; nie są to dane konta na żywo ani bieżąca wycena.
{
"status": {
"code": 200,
"msg": "Results: 1",
"results": 1
},
"response": [
{
"number": "12025550123",
"info": {
"uuid": "NUMBER_ID",
"prefix_uuid": "PREFIX_ID",
"country_iso": "US",
"is_mobile": 1
},
"price": [
{
"uuid": "PRICE_ID",
"monthly_price": "ACCOUNT_MONTHLY_PRICE",
"setup_price": "ACCOUNT_SETUP_PRICE",
"per_minute": "ACCOUNT_INCOMING_RATE",
"channels": "PLAN_CHANNELS"
}
],
"features": [
"voice",
"sms",
"mms",
"t38"
]
}
]
}Błędy
- 404: Nieprawidłowy identyfikator prefiksu, kraj lub obszar: odśwież wybór indywidualnego prefiksu mobilnego.
- 404: Nie znaleziono numerów: może to oznaczać brak użytecznego zapasu, wyłączoną usługę, nieudane wyszukanie u dostawcy, nieobsługiwany wybór lub ograniczenia konta. Nie jest to dowód autorytatywnej zerowej liczby inwentarza.
Dostępność i efekty uboczne
- Wyszukiwanie nie wynajmuje i nie rezerwuje numeru, a przeanalizowana ścieżka nie obciąża konta kwotą zakupu. Kontaktuje się z dostawcą inwentarza i może zająć czas.
- Udane wyszukiwania zapisują powiązane z kontem wpisy pamięci podręcznej numerów i cen oraz dzienniki zapytań. Powtórzenie wyszukiwania nie jest rezerwacją, blokadą ceny ani zakupem.
- Zwrócone ceny, warunki, ograniczenia i możliwości muszą zostać przejrzane dla wybranego konta i numeru. Etykieta funkcji nie ustanawia aktywacji, zatwierdzenia wiadomości ani przetestowanej funkcjonalności usługi.