Katalogländer auflisten (älteres Format)

Älterer Endpunkt, der sichtbare Länder zurückgibt, die mit dem von GET /v3/other/{isocode} verwendeten Sonderrufnummernkatalog verknüpft sind. Der Antwortinhalt hat das Format {code, data}. Die Verfügbarkeit von Rufnummern wird nicht geprüft. Verwenden Sie GET /v3/getcountries, um Länder mit verfügbaren Rufnummern zu finden.

Dieser ältere Endpunkt gibt einen Antwortinhalt im Format {"code", "data"} statt der standardmäßigen status/response-Antwortstruktur zurück. Er listet sichtbare Länder auf, die mit dem Sonderrufnummernkatalog verknüpft sind, und prüft nicht die Verfügbarkeit von Rufnummern.

Für neue Integrationen:

Verwenden Sie GET /v3/getcountries, um Länder mit verfügbaren Rufnummern zu finden.
Verwenden Sie GET /v3/other/{isocode}, um zu sehen, welche Arten von Sonderrufnummern in einem Land tatsächlich angeboten werden. Für ein hier aufgeführtes Land kann dort dennoch ein leerer Katalog zurückgegeben werden.

Anfrage

Erforderlich: HTTP Basic oder ein Bearer-Token (siehe Authentifizierung und API-Antworten). Bei fehlgeschlagener Authentifizierung wird vor der Abfrage eine Antwort mit HTTP 401 in der standardmäßigen Antwortstruktur zurückgegeben.

GET ohne Parameter und ohne Anfrageinhalt.

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

Antwort

Antwortinhalt im älteren Format ohne die standardmäßige Antwortstruktur: {code: 200, data: [...]}. Es gibt weder ein status-Objekt noch die Felder msg oder results. data listet Länder ohne garantierte Reihenfolge auf. Felder: countrycode (Landesvorwahl ohne '+'), name, description (derselbe Wert wie name), isocode, latitude und longitude. Die Felder is_mobile, sms_coverage und next_function sind nicht vorhanden. Ein Land wird aufgeführt, wenn es sichtbar und mit dem Sonderrufnummernkatalog verknüpft ist. Die Verfügbarkeit von Rufnummern wird nicht geprüft. Daher kann es für ein aufgeführtes Land derzeit keine verfügbaren Rufnummern geben. Wenn kein Land die Kriterien erfüllt, hat data den Wert null.

Beispielhafte Antwortstruktur; keine aktuellen Kontodaten und kein aktuelles Preisangebot.

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

Fehler

401: Authentifizierung fehlt oder ist fehlgeschlagen. Wird mit HTTP status 401 in der standardmäßigen status/response-Antwortstruktur gesendet, nicht im Antwortinhalt des älteren Formats.

Verfügbarkeit und Nebenwirkungen

Nur eine Abfrage. Es wird nichts reserviert, bestellt oder geändert.