Absenderkennungen

Die API zur Validierung von Absenderkennungen ermöglicht es Ihnen, automatisch Caller IDs für die Voice API zu validieren. Nach Aufruf dieser API erhalten Sie bei Erfolg einen Code zurück. Gleichzeitig wird die angegebene Rufnummer einen Anruf von uns erhalten. Hier muss dann der zurückgegebene Code über die Tastatur des Telefons per DTMF eingegeben werden.


Absender für Voice validieren

Um eine Rufnummer für Voice verwenden zu können, müssen Sie diese erst validieren. Dazu erhalten Sie einen Anruf, bei dem ein Code eingegeben werden muss. Im Erfolgsfall und sofern die Rufnummer noch nicht für Ihren Account validiert wurde, erhalten Sie ein JSON-Objekt mit dem Code zurück.

Parameter

  • Name
    number
    Type
    string
    Description

    Die zu validierende Rufnummer. Das Format ist nahezu beliebig – unser Gateway formatiert die Nummer automatisch korrekt.

Optionale Parameter

  • Name
    callback
    Type
    string
    Description

    Callback URL, die aufgerufen werden soll, sobald die Validierung erfolgreich durchgeführt wurde.

Anfrage

POST
/api/validate_for_voice
curl -G https://gateway.seven.io/api/validate_for_voice \
  -H "X-Api-Key: IHR_API_SCHLÜSSEL" \
  -H "Accept: application/json"
  -d "number=49176123456789"

Antwort im Erfolgsfall

{
    "code": "699350",
    "error": null,
    "success": true
}

Antwort falls Rufnummer ungültig

{
"id": null,
"sender": "49176123456789",
"formatted_output": null,
"success": false,
"error": "Empf\u00e4ngernummer ung\u00fcltig",
"voice": false
}

Antwort falls Rufnummer bereits validiert

{
  "id": 12345,
  "sender": "49176123456789",
  "formatted_output": "+49 176 123456789",
  "success": true,
  "error": "Die Absenderkennung ist bereits gespeichert.",
  "voice": true
}
Zuletzt aktualisiert: Vor 6 Monaten