Enviar un SMS

​

Qué es

​

Antes de empezar

• Guarde su clave de API de YCloud en YCLOUD_API_KEY.
• Aplique el formato E.164 al número del destinatario.
• Registre un senderId aprobado cuando el destino lo requiera.
• Proporcione un signature aprobado para los mensajes enviados a China continental.

​

Cómo funciona

​

Solicitud

​

Campos de solicitud

​

Ejemplo de solicitud

curl --request POST https://api.ycloud.com/v2/sms \
  --header "X-API-Key: $YCLOUD_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "to": "+16315551111",
    "text": "Your verification code is 123456.",
    "externalId": "login-10001"
  }'

​

Respuesta

​

Ejemplo de respuesta

{
  "id": "MESSAGE_ID",
  "to": "+16315551111",
  "text": "Your verification code is 123456.",
  "regionCode": "US",
  "totalSegments": 1,
  "status": "accepted",
  "externalId": "login-10001",
  "createTime": "2026-07-16T12:00:00.000Z"
}

​

Campos de respuesta

​

Estado de entrega

​

Límites y solución de problemas

• La disponibilidad del ID del remitente y las reglas de contenido varían según el destino.
• Los mensajes largos pueden usar múltiples segmentos de SMS y costar más.
• No vuelva a intentar una solicitud aceptada sin una estrategia de idempotencia. Una solicitud repetida puede enviar un mensaje duplicado.
• Utilice id y externalId devueltos cuando investigue un problema de entrega.