Действие CreateSMSSandboxPhoneNumber
Добавляет тестовый телефонный номер для канала SMS-уведомлений в песочнице и отправляет на него код подтверждения.
Если телефонный номер уже есть в списке в ожидании подтверждения, повторно отправляет на него новый код подтверждения.
HTTP-запрос
POST https://notifications.yandexcloud.net/
Query-параметры
| Параметр | Описание |
|---|---|
Action |
string Обязательное поле. Параметр для обозначения типа операции. Значение: CreateSMSSandboxPhoneNumber. |
PhoneNumber |
string Обязательное поле. Номер телефона в формате E.164 |
SMSChannelArn |
string Обязательное поле. Идентификатор канала SMS-уведомлений. Пример: arn:aws:sns::b1gvlrnlei4l******:sms/channelname. |
LanguageCode |
string Код языка, используемый для отправки кода подтверждения. Возможные значения:
|
ResponseFormat |
string Формат ответа. Возможные значения:
|
Ответ
Успешный ответ
При отсутствии ошибок Cloud Notification Service отвечает HTTP-кодом 200.
Успешный ответ содержит дополнительные данные в формате XML или JSON в зависимости от указанного параметра ResponseFormat.
Схема данных:
<?xml version="1.0" encoding="UTF-8"?>
<CreateSMSSandboxPhoneNumberResponse>
<ResponseMetadata>
<RequestId>string</RequestId>
</ResponseMetadata>
</CreateSMSSandboxPhoneNumberResponse>
{
"ResponseMetadata": {
"RequestId": "string"
}
}
Где RequestId — идентификатор запроса.
Ответ с ошибкой
При возникновении ошибки Cloud Notification Service отвечает сообщением с соответствующим HTTP-кодом и дополнительным описанием в формате XML или JSON в зависимости от указанного параметра ResponseFormat.
Схема данных:
<?xml version="1.0" encoding="UTF-8"?>
<ErrorResponseXML>
<RequestId>string</RequestId>
<Error>
<Code>string</Code>
<Message>string</Message>
</Error>
</ErrorResponseXML>
{
"ErrorResponse": {
"RequestId": "string",
"Error": {
"Code": "string",
"SubCode": "string",
"Message": "string"
}
}
}
Где:
RequestId— идентификатор запроса.Code— код ошибки.Message— описание ошибки.
Перечень общих кодов ошибок для всех действий см. в разделе Ошибки.
Ошибки, специфичные для действия CreateSMSSandboxPhoneNumber:
| HTTP | Код ошибки | Дополнительный код | Описание |
|---|---|---|---|
| 400 | UserError | SMSSandboxPhoneNumberLimitExceeded | Исчерпан лимит на количество подтвержденных номеров на облако или канал SMS-уведомлений. |
| 400 | UserError | WrongSMSChannelState | Канал SMS-уведомлений не находится в статусе Sandbox. |
| 400 | UserError | SMSSandboxPhoneNumberAlreadyVerified | Указанный номер уже подтвержден в данном канале SMS-уведомлений. |
| 400 | UserError | InvalidPhoneNumberRegion | Нельзя использовать телефонные номера не из России. |
| 400 | ThrottlingException | OTPRateLimitExceeded | Превышена допустимая частота отправки кодов подтверждения. |