Entwickler

GET/v3/get_document_countries

Registrierungsländer auflisten

Ermitteln Sie die ISO-Ländercodes und Ländernamen aus dem aktuellen Katalog für die Rufnummernregistrierung.

Auf dieser Seite
  1. Registrierungsland auswählen
  2. Wenn ein Land fehlt
  3. Anfrage
  4. Antwort
  5. Fehler
  6. Verfügbarkeit und Nebenwirkungen

Registrierungsland auswählen

Kopieren Sie einen ISO-Ländercode aus dieser Antwort, bevor Sie Rufnummerntypen oder Registrierungsanforderungen abfragen. Verwenden Sie das Land des Rufnummerndienstes und nicht automatisch das Land der Staatsangehörigkeit oder der Adresse des Kunden.

Wenn ein Land fehlt

Wenn ein Land fehlt, ist das kein Beleg dafür, dass keine Dokumente erforderlich sind oder MultiTEL dort keine Rufnummer bereitstellen kann. Halten Sie die Auswahl für die Registrierung von der Rufnummernsuche getrennt und wenden Sie sich an den Support, wenn das benötigte Land nicht verfügbar ist.

Anfrage

Verwenden Sie die Zugangsdaten Ihres freigeschalteten API-Kontos über HTTPS. Unterstützt werden HTTP-Basisauthentifizierung und freigeschaltete Bearer-Token für API-Konten; es gelten die Einschränkungen des Kontos.

GET mit einem beliebigen dokumentierten Parameter im URL-Pfad.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/get_document_countries"

Antwort

Prüfen Sie sowohl status.code im JSON-Antwortkörper als auch den HTTP-Status. response ist ein nach Namen sortiertes Array mit den Zeichenfolgen iso und name in Großbuchstaben. Dieser Registrierungskatalog unterscheidet sich von der Suche im Rufnummernbestand und von der allgemeinen Länderliste für Adressen. Er stellt keine Zusicherung dar, dass jedes Land oder jede verfügbare Ergebnisseite des vorgelagerten Systems zurückgegeben wurde.

Beispielhafte Antwortstruktur; keine aktuellen Kontodaten und kein aktuelles Angebot.

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "iso": "US",
      "name": "United States"
    }
  ]
}

Fehler

  • 500: Unable to load available registration countries: Die Abfrage der Registrierungsländer hat keine Daten geliefert. Versuchen Sie es später erneut; behandeln Sie dies nicht als erfolgreich abgerufenen, leeren Katalog.

Verfügbarkeit und Nebenwirkungen

  • Diese Abfrage des Katalogs bzw. der Anforderungen erstellt keine Identität, lädt keinen Nachweis hoch, registriert keine Rufnummer und gibt keine Bestellung auf.
  • Eine erfolgreiche Katalogantwort bedeutet weder eine Genehmigung Ihrer Dokumente noch eine Bestätigung, dass eine ausgewählte Rufnummer aktiviert werden kann.