Почта

Список ящиков домена

URL: /api/v1/mail/domains/{id}/mailboxes/
Метод: GET
Результат: JSON

  • id - ID почтового домена

Опциональные параметры запроса:

  • offset(int) - Индекс первой строки выборки, начиная с 0
  • limit(int) - Количество элементов в выборке

Коды ответов

Код Описание
200 Успешный запрос

Возвращаемое значение:

  • count (int) - Количество элементов
  • entities - Список почтовых ящиков
    • id(int) - Идентификатор ящика
    • name(str) - Имя ящика
    • aliases(str) - Адреса ящиков для пересылки почты
    • comment(str) - Комментарий к ящику
    • created(datetime) - Дата создания почтового ящика
    • domain_id(int) - ID домена
    • is_local(bool) - Хранение почты в ящике
    • quota(int) - Максимальный объем дискового пространства для ящика (МБ)
    • state(str) - Состояние почтового ящика
    • updated(datetime) - Дата изменения почтового ящика
    • used(int) - Занятое дисковое пространство (МБ)

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

curl --request GET 'https://api-ms.netangels.ru/api/v1/mail/domains/{id}/mailboxes/?limit=10' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"

Создание нового ящика

URL: /api/v1/mail/mailboxes/
Метод: POST
Результат: JSON

Обязательные параметры запроса:

  • name(str) - Имя почтового ящика
  • password(str) - Пароль для почтового ящика

Опциональные параметры запроса:

  • comment(str) - Комментарий

Коды ответов

Код Описание
201 Успешный запрос
400 Данные в запросе имеют неверный формат или отсутствуют обязательные параметры

Возвращаемое значение:

Почтовый ящик

  • id(int) - Идентификатор ящика
  • name(str) - Имя ящика
  • aliases(str) - Адреса ящиков для пересылки почты
  • comment(str) - Комментарий к ящику
  • created(datetime) - Дата создания почтового ящика
  • domain_id(int) - ID домена
  • is_local(bool) - Хранение почты в ящике
  • quota(int) - Максимальный объем дискового пространства для ящика (МБ)
  • state(str) - Состояние почтового ящика
  • updated(datetime) - Дата изменения почтового ящика
  • used(int) - Занятое дисковое пространство (МБ)

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

curl --request POST 'https://api-ms.netangels.ru/api/v1/mail/mailboxes/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY" \
    --header "Content-Type: application/json" \
    --data '{
          "name": "mailbox1", 
          "password": "PassWord", 
          "comment": "Ящик номер 1" 
    }'

Информация о ящике

URL: /api/v1/mail/mailboxes/{id}/
Метод: GET
Результат: JSON

  • id - ID почтового ящика

Коды ответов

Код Описание
200 Успешный запрос

Возвращаемое значение:

Почтовый ящик

  • id(int) - Идентификатор ящика
  • name(str) - Имя ящика
  • aliases(str) - Адреса ящиков для пересылки почты
  • comment(str) - Комментарий к ящику
  • created(datetime) - Дата создания почтового ящика
  • domain_id(int) - ID домена
  • is_local(bool) - Хранение почты в ящике
  • quota(int) - Максимальный объем дискового пространства для ящика (МБ)
  • state(str) - Состояние почтового ящика
  • updated(datetime) - Дата изменения почтового ящика
  • used(int) - Занятое дисковое пространство (МБ)

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

curl --request GET 'https://api-ms.netangels.ru/api/v1/mail/mailboxes/{id}/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"

Изменение почтового ящика

URL: /api/v1/mail/mailboxes/{id}/
Метод: PUT
Результат: JSON

  • id - ID почтового ящика

Опциональные параметры запроса:

  • comment(str) - Комментарий
  • quota(int) - Максимальный объем дискового пространства для ящика (МБ)
  • is_local(bool) - Хранение почты в ящике

Коды ответов

Код Описание
201 Успешный запрос
400 Данные в запросе имеют неверный формат или отсутствуют обязательные параметры

Возвращаемое значение:

Почтовый ящик

  • id(int) - Идентификатор ящика
  • name(str) - Имя ящика
  • aliases(str) - Адреса ящиков для пересылки почты
  • comment(str) - Комментарий к ящику
  • created(datetime) - Дата создания почтового ящика
  • domain_id(int) - ID домена
  • is_local(bool) - Хранение почты в ящике
  • quota(int) - Максимальный объем дискового пространства для ящика (МБ)
  • state(str) - Состояние почтового ящика
  • updated(datetime) - Дата изменения почтового ящика
  • used(int) - Занятое дисковое пространство (МБ)

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

curl --request PUT 'https://api-ms.netangels.ru/api/v1/mail/mailboxes/{id}/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY" \
    --header "Content-Type: application/json" \
    --data '{
          "comment": "Ящик номер 1", 
          "quota": 1000, 
          "is_local": true 
    }'

Удаление ящика

URL: /api/v1/mail/mailboxes/{id}/
Метод: DELETE

  • id - ID почтового ящика

Коды ответов

Код Описание
200 Успешный запрос

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

curl --request DELETE 'https://api-ms.netangels.ru/api/v1/mail/mailboxes/{id}/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"

Изменение пароля ящика

URL: /api/v1/mail/mailboxes/{id}/change-password/
Метод: PUT
Результат: JSON

  • id - ID почтового ящика

Обязательные параметры запроса:

  • password(str) - Пароль для почтового ящика

Коды ответов

Код Описание
201 Успешный запрос
400 Данные в запросе имеют неверный формат или отсутствуют обязательные параметры

Возвращаемое значение:

Почтовый ящик

  • id(int) - Идентификатор ящика
  • name(str) - Имя ящика
  • aliases(str) - Адреса ящиков для пересылки почты
  • comment(str) - Комментарий к ящику
  • created(datetime) - Дата создания почтового ящика
  • domain_id(int) - ID домена
  • is_local(bool) - Хранение почты в ящике
  • quota(int) - Максимальный объем дискового пространства для ящика (МБ)
  • state(str) - Состояние почтового ящика
  • updated(datetime) - Дата изменения почтового ящика
  • used(int) - Занятое дисковое пространство (МБ)

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

curl --request PUT 'https://api-ms.netangels.ru/api/v1/mail/mailboxes/{id}/change-password/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY" \
    --header "Content-Type: application/json" \
    --data '{
          "password": "PassWord" 
    }'

Добавление адреса пересылки

URL: /api/v1/mail/mailboxes/{id}/add-alias/
Метод: PUT
Результат: JSON

  • id - ID почтового ящика

Обязательные параметры запроса:

  • alias(str) - Ящик для пересылки

Коды ответов

Код Описание
201 Успешный запрос
400 Данные в запросе имеют неверный формат или отсутствуют обязательные параметры

Возвращаемое значение:

Почтовый ящик

  • id(int) - Идентификатор ящика
  • name(str) - Имя ящика
  • aliases(str) - Адреса ящиков для пересылки почты
  • comment(str) - Комментарий к ящику
  • created(datetime) - Дата создания почтового ящика
  • domain_id(int) - ID домена
  • is_local(bool) - Хранение почты в ящике
  • quota(int) - Максимальный объем дискового пространства для ящика (МБ)
  • state(str) - Состояние почтового ящика
  • updated(datetime) - Дата изменения почтового ящика
  • used(int) - Занятое дисковое пространство (МБ)

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

curl --request PUT 'https://api-ms.netangels.ru/api/v1/mail/mailboxes/{id}/add-alias/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY" \
    --header "Content-Type: application/json" \
    --data '{
          "alias": "mail@google.com" 
    }'

Удаление ящика для пересылки

URL: /api/v1/mail/mailboxes/{id}/delete-alias/
Метод: PUT
Результат: JSON

  • id - ID почтового ящика

Обязательные параметры запроса:

  • alias(str) - Ящик для пересылки

Коды ответов

Код Описание
201 Успешный запрос
400 Данные в запросе имеют неверный формат или отсутствуют обязательные параметры

Возвращаемое значение:

Почтовый ящик

  • id(int) - Идентификатор ящика
  • name(str) - Имя ящика
  • aliases(str) - Адреса ящиков для пересылки почты
  • comment(str) - Комментарий к ящику
  • created(datetime) - Дата создания почтового ящика
  • domain_id(int) - ID домена
  • is_local(bool) - Хранение почты в ящике
  • quota(int) - Максимальный объем дискового пространства для ящика (МБ)
  • state(str) - Состояние почтового ящика
  • updated(datetime) - Дата изменения почтового ящика
  • used(int) - Занятое дисковое пространство (МБ)

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

curl --request PUT 'https://api-ms.netangels.ru/api/v1/mail/mailboxes/{id}/delete-alias/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY" \
    --header "Content-Type: application/json" \
    --data '{
          "alias": "mail@google.com" 
    }'

Очистка почтового ящика

URL: /api/v1/mail/mailboxes/{id}/cleanup/
Метод: PUT

  • id - ID почтового ящика

Коды ответов

Код Описание
200 Успешный запрос

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

curl --request PUT 'https://api-ms.netangels.ru/api/v1/mail/mailboxes/{id}/cleanup/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"