Wybierz kraj rejestracji
Skopiuj kod ISO kraju z tej odpowiedzi, zanim wyślesz zapytanie o typy numerów lub wymagania rejestracyjne. Użyj kraju, w którym świadczona jest usługa numeru, a nie automatycznie kraju obywatelstwa lub adresu klienta.
Gdy brakuje kraju
Brak kraju nie jest dowodem na to, że dokumenty nie są wymagane ani że MultiTEL nie może dostarczyć tam numeru. Oddziel wybór kraju do rejestracji od wyszukiwania numerów i skontaktuj się z pomocą techniczną, jeśli potrzebny kraj jest niedostępny.
Żądanie
Użyj danych uwierzytelniających swojego aktywnego konta API przez HTTPS. Obsługiwane są uwierzytelnianie podstawowe HTTP oraz aktywne tokeny typu bearer dla kont API; obowiązują ograniczenia konta.
GET z dowolnym udokumentowanym parametrem w ścieżce URL.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/get_document_countries"Odpowiedź
Sprawdź zarówno status.code w treści JSON, jak i status HTTP. response to tablica ciągów znaków iso i name zapisanych wielkimi literami, posortowana według nazwy. Ten katalog rejestracji różni się od wyszukiwania dostępnych numerów oraz od ogólnej listy krajów używanej w adresach. Nie stanowi gwarancji, że zwrócono każdy kraj lub każdą dostępną stronę wyników z systemu nadrzędnego.
Przykładowa struktura odpowiedzi; nie są to bieżące dane konta ani aktualna oferta cenowa.
{
"status": {
"code": 200,
"msg": "",
"results": 1
},
"response": [
{
"iso": "US",
"name": "United States"
}
]
}Błędy
- 500: Unable to load available registration countries: zapytanie o kraje rejestracji nie zwróciło danych. Spróbuj ponownie później; nie traktuj tego jako pomyślnego pobrania pustego katalogu.
Dostępność i skutki uboczne
- To zapytanie o katalog lub wymagania nie tworzy tożsamości, nie przesyła dokumentu potwierdzającego, nie rejestruje numeru ani nie składa zamówienia.
- Pomyślna odpowiedź katalogu nie oznacza zatwierdzenia dokumentów ani potwierdzenia, że wybrany numer można aktywować.