Absenderkennungen

La API para la validación de identificaciones de remitente le permite validar automáticamente las IDs de llamada para la API de voz. Después de llamar a esta API, recibirá un código si tiene éxito. Al mismo tiempo, el número de teléfono especificado recibirá una llamada de nosotros. Aquí, el código devuelto debe ingresarse a través del teclado del teléfono mediante DTMF.

Validar remitente para Voice

Para poder usar un número de teléfono para Voice, primero debe validarlo. Para ello, recibirá una llamada en la que se debe ingresar un código. En caso de éxito y si el número de teléfono aún no ha sido validado para su cuenta, recibirá un objeto JSON con el código.

Parámetros

Name
number
Type
string
Description
El número de teléfono a validar. El formato es casi arbitrario: nuestra pasarela formatea el número automáticamente de manera correcta.

Parámetros opcionales

Name
callback
Type
string
Description
URL de callback que debe ser llamada una vez que la validación se haya realizado con éxito.

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ängernummer ungültig",
    "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
}