Identificações de Remetente

A API para validação de identificações de remetente permite validar automaticamente IDs de chamada para a API de Voz. Após chamar esta API, você receberá um código de retorno em caso de sucesso. Simultaneamente, o número de telefone especificado receberá uma chamada nossa. Neste momento, o código retornado deve ser inserido através do teclado do telefone via DTMF.

Validar remetente para Voz

Para usar um número de telefone para Voz, você deve primeiro validá-lo. Para isso, você receberá uma chamada na qual um código deve ser inserido. Em caso de sucesso e se o número ainda não tiver sido validado para sua conta, você receberá um objeto JSON com o código de retorno.

Parâmetros

  • Name
    number
    Type
    string
    Description

    O número de telefone a ser validado. O formato é quase irrestrito – nosso gateway formata o número automaticamente de forma correta.

Parâmetros Opcionais

  • Name
    callback
    Type
    string
    Description

    URL de callback que deve ser chamada assim que a validação for realizada com sucesso.

Requisição

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"

Resposta em caso de sucesso

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

Resposta se o número for inválido

{
    "id": null,
    "sender": "49176123456789",
    "formatted_output": null,
    "success": false,
    "error": "Empfängernummer ungültig",
    "voice": false
}

Resposta se o número já estiver validado

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