MultiTEL
Programiści

GET/v3/countries

Lista krajów w katalogu (starszy format)

Starszy punkt końcowy zwracający widoczne kraje powiązane z katalogiem numerów specjalnych używanym przez GET /v3/other/{isocode}. Treść odpowiedzi ma format {code, data}. Nie sprawdza dostępności numerów. Użyj GET /v3/getcountries, aby znaleźć kraje z dostępnymi numerami.

Na tej stronie
  1. Żądanie
  2. Odpowiedź
  3. Błędy
  4. Dostępność i skutki uboczne

Ten starszy punkt końcowy zwraca treść w formacie {"code", "data"} zamiast standardowej struktury status/response. Zwraca listę widocznych krajów powiązanych z katalogiem numerów specjalnych i nie sprawdza dostępności numerów.

W przypadku nowych integracji:

  • Użyj GET /v3/getcountries, aby znaleźć kraje z dostępnymi numerami.
  • Użyj GET /v3/other/{isocode}, aby sprawdzić, jakie typy numerów specjalnych są faktycznie oferowane w danym kraju. Dla kraju wymienionego tutaj tamten punkt końcowy nadal może zwrócić pusty katalog.

Żądanie

Wymagane: uwierzytelnianie HTTP Basic lub token Bearer (zobacz Uwierzytelnianie i odpowiedzi API). W przypadku nieudanego uwierzytelnienia przed wykonaniem wyszukiwania zwracana jest odpowiedź HTTP 401 w standardowej strukturze.

GET bez parametrów i bez treści żądania.

curl --user "$API_USER:$API_PASSWORD" 'https://api.multitel.net/v3/countries'

Odpowiedź

Treść w starszym formacie, bez standardowej struktury odpowiedzi: {code: 200, data: [...]}. Nie ma obiektu status ani pól msg i results. data zawiera listę krajów bez gwarantowanej kolejności. Pola: countrycode (numer kierunkowy kraju bez '+'), name, description (ta sama wartość co name), isocode, latitude i longitude. Nie ma pól is_mobile, sms_coverage ani next_function. Kraj jest uwzględniany na liście, gdy jest widoczny i powiązany z katalogiem numerów specjalnych. Dostępność numerów nie jest sprawdzana, więc kraj znajdujący się na liście może obecnie nie mieć żadnych dostępnych numerów. Jeśli żaden kraj nie spełnia kryteriów, data ma wartość null.

Przykładowa struktura odpowiedzi; nie są to bieżące dane konta ani aktualna oferta cenowa.

{
  "code": 200,
  "data": [
    {
      "countrycode": "33",
      "name": "France",
      "description": "France",
      "isocode": "FR",
      "latitude": "46.0000",
      "longitude": "2.0000"
    }
  ]
}

Błędy

  • 401: Brak uwierzytelnienia lub uwierzytelnienie nie powiodło się. Odpowiedź jest wysyłana z HTTP status 401 w standardowej strukturze status/response, a nie w treści w starszym formacie.

Dostępność i skutki uboczne

  • Wyłącznie wyszukiwanie. Niczego nie rezerwuje, nie zamawia ani nie zmienia.