Identifiants expéditeur
L'API pour valider les identifiants d'expéditeur vous permet de valider automatiquement les caller IDs pour l'API Voice. Après avoir appelé cette API, vous recevrez un code en retour si c'est réussi. En même temps, le numéro de téléphone spécifié recevra un appel de notre part. Le code retourné doit ensuite être saisi via le clavier téléphonique en utilisant DTMF.
Valider un expéditeur pour la voix
Pour pouvoir utiliser un numéro de téléphone pour la voix, vous devez d'abord le valider. Pour cela, vous recevrez un appel dans lequel un code doit être saisi. Si l'appel est réussi et que le numéro n'a pas encore été validé pour votre compte, vous recevrez un objet JSON avec le code.
Paramètre
- Name
number
- Type
- string
- Description
Le numéro de téléphone à valider. Le format est presque arbitraire - notre passerelle formate automatiquement le numéro correctement.
Paramètres optionnels
- Name
callback
- Type
- string
- Description
URL de callback à appeler dès que la validation a été terminée avec succès.
Requête
curl -G https://gateway.seven.io/api/validate_for_voice \
-H "X-Api-Key: VOTRE_CLÉ_API" \
-H "Accept: application/json"
-d "number=49176123456789"
Réponse en cas de succès
{
"code": "699350",
"error": null,
"success": true
}
Réponse si le numéro de téléphone est invalide
{
"id": null,
"sender": "49176123456789",
"formatted_output": null,
"success": false,
"error": "Numéro de réception invalide",
"voice": false
}
Réponse si le numéro de téléphone est déjà validé
{
"id": 12345,
"sender": "49176123456789",
"formatted_output": "+49 176 123456789",
"success": true,
"error": "L'identifiant d'expéditeur est déjà enregistré.",
"voice": true
}