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
}