Отправка SMS

​

Что это

​

Перед началом

• Сохраните ваш API-ключ YCloud в YCLOUD_API_KEY.
• Отформатируйте номер получателя в формате E.164.
• Зарегистрируйте одобренный senderId, если это требуется для направления.
• Укажите одобренную signature для сообщений, отправляемых в материковый Китай.

​

Как это работает

​

Запрос

​

Поля запроса

​

Пример запроса

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"
  }'

​

Ответ

​

Пример ответа

{
  "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"
}

​

Поля ответа

​

Статус доставки

​

Ограничения и устранение неполадок

• Доступность Sender ID и правила по контенту зависят от направления.
• Длинные сообщения могут использовать несколько SMS-сегментов и стоить дороже.
• Не повторяйте принятый запрос без стратегии идемпотентности. Повторный запрос может отправить дубликат сообщения.
• При расследовании проблем доставки используйте возвращённые id и externalId.