发送语音验证码

​

简介

​

开始之前

• 为您的 YCloud 账户激活语音功能。
• 收集 E.164 格式的接收者电话号码。
• 生成一个短期的 4 到 6 位数字验证码。
• 选择一种支持的语言。
• 决定状态是通过回调 URL 还是配置的 Webhook 接收。

​

工作原理

1. 生成并安全地存储验证质询。
2. 通过 Voice API 发送验证码。
3. 存储返回的语音记录 ID 和您的 externalId。
4. 通过回调或 Webhook 接收发送状态更新。
5. 在您的应用程序中验证验证码并使质询过期。

​

请求

curl --request POST https://api.ycloud.com/v2/voices \
  --header "X-API-Key: $YCLOUD_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "to": "+16315551111",
    "verificationCode": "123456",
    "language": "en",
    "externalId": "login-7f10b6",
    "callbackUrl": "https://example.com/webhooks/voice"
  }'

​

响应

{
  "id": "VOICE_MESSAGE_ID"
}

​

递送状态

​

保护验证流程

• 让验证码快速过期。
• 限制每个用户、目标地址、IP 和设备的发送和检查尝试次数。
• 绝不记录验证码。
• 防止验证码在验证通过后被重复使用。
• 避免泄露电话号码是否属于某个账户。

​

限制与故障排除

• verificationCode 必须包含 4 到 6 位数字。
• 电话号码必须使用 E.164 格式。
• 语言的可用性可能因国家或地区而异。
• 使用 externalId 和 YCloud 记录 ID 来调查发送情况。
• 当您希望 YCloud 将发送和验证码 检查作为一个验证生命周期进行管理时，请优先使用 Verify API。