Настройка отправителей рассылок¶

Список адресов email-отправителей¶

Адреса, указываемые при выпуске рассылки как "адрес отправителя" или как "обратный адрес", должны быть подтверждены перед использованием.

При каждом вызове issue.emailsender.set на используемый в нём адрес высылается письмо со ссылкой подтверждения.

После подтверждения адрес может быть использован в выпуске.

Если адрес используемый как "адрес отправителя" или "обратный адрес" не добавлен в список отправителей вообще, то его можно использовать, если его домен точно равен домену подтверждённого DKIM, используемого в выпуске. Это упрощает работу, когда адресов отправителей много или они генерируются автоматически по какому-то правилу.

{

  "action" : "issue.emailsender.list" 

}

ответ

{

 <общие поля>

,"list" : [

            {

             "id" : уникальный идентификатор

            ,"name" : "адрес отправителя" 

            ,"label" : "имя отправителя" 

            ,"onmoderation" : 0|1 -- 0 - адрес одобрен, 1 - адрес ждёт подтверждения

            ,"create.date" : "дата и время создания" -- Ys, null

            ,"update.date" : "дата и время последнего изменения" -- Ys, null
            }

            ...

           ]

}

Чтение адреса email-отправителя¶

{

  "action" : "issue.emailsender.get" 

  ,"id" : идентификатор

}

ответ

{
  <общие поля>

  "obj" : {

            ,"id" : идентификатор

            ,"name" : "адрес отправителя" 

            ,"label" : "имя отправителя" 

            ,"onmoderation" : 0|1

            ,"create.date" : "дата и время создания" -- Ys, null

            ,"update.date" : "дата и время последнего изменения" -- Ys, null
          }

}

Создание или изменение адреса email-отправителя¶

{
  "action" : "issue.emailsender.set" 

  ,"obj" : {

             "name" : "адрес отправителя" -- обязательно при создании

            ,"label" : "имя отправителя" -- необязательно

           }

  -- необязательные

  ,"id" : идентификатор -- если не указан, создается новый

  ,"return_fresh_obj" : "нужно вернуть данные объекта -- да, нет ( 1 | 0 )" 

}

ответ

{

 <общие поля>

 ,"id" : идентификатор отправителя

 ,obj  { ... } -- объект в формате issue.emailsender.get если "return_fresh_obj" : 1

}

Удаление адреса email-отправителя¶

{

  "action" : "issue.emailsender.delete" 

  ,"id" : идентификатор

}

ответ

{

 <общие поля>

}

Список имён sms-отправителей¶

{

  "action" : "issue.smssender.list" 

}

ответ

{

 <общие поля>

,"list" : [

            {

             "id" : уникальный идентификатор

            ,"name" : "отправитель" 

            ,"onmoderation" : 0|1 -- 0 - имя одобрено, 1 - имя ещё на модерации

            ,"create.date" : "дата и время создания" -- Ys, null

            ,"update.date" : "дата и время последнего изменения" -- Ys, null
            }

            ...

           ]

}

Чтение имени sms-отправителя¶

{

  "action" : "issue.smssender.get" 

  ,"id" : идентификатор sms-отправителя

}

ответ

{
  <общие поля>

  "obj" : {

             "id" : идентификатор sms-отправителя

            ,"name" : "отправитель" 

            ,"onmoderation" : 0|1

            ,"create.date" : "дата и время создания" -- Ys, null

            ,"update.date" : "дата и время последнего изменения" -- Ys, null
          }

}

Создание или изменение имени sms-отправителя¶

Создание или изменение имени автоматически попадает на модерацию.

Если имя состоит из одних цифр, то его длина не должна превышать 15 символов.

Иначе имя может содержать от 1 до 13 символов больших и маленьких латинских букв и цифр.

{
  "action" : "issue.smssender.set" 

  ,"obj" : {

       "name" : "отправитель" 

           }

  -- необязательные

 ,"id" : идентификатор sms-отправителя -- если не указан, создается новый

 ,"return_fresh_obj" : "нужно вернуть данные объекта -- да, нет ( 1 | 0 )" 

}

ответ

{

 <общие поля>

 ,"id" : идентификатор sms-отправителя

 ,"obj" : { ... } -- объект в формате issue.smssender.get если "return_fresh_obj" : 1

}

Удаление имени sms-отправителя¶

{

  "action" : "issue.smssender.delete" 

 ,"id" : идентификатор sms-отправителя

}

ответ

{

 <общие поля>

}