Создать белый список

  1. HTTP-запрос
  2. Path-параметры
  3. Тело запроса
    1. Представление
    2. Поля
  4. Ответы
    1. Код 200
      1. Представление
      2. Поля
    2. Код 401
      1. Представление
      2. Поля
    3. Код 403
      1. Представление
      2. Поля
    4. Код 404
      1. Представление
      2. Поля
    5. Код 500
      1. Представление
      2. Поля

Создает или заменяет список разрешенных IP-адресов и CIDR-подсетей.

Ограничение. Чтобы выполнить запрос, приложению требуется разрешение на управление настройками антиспама. Убедитесь, что вы включили его при настройке приложения на OAuth-сервере Яндекса.

Пример:

curl --request POST https://api360.yandex.net/admin/v1/org/{orgId}/mail/antispam/allowlist/ips \
    --header 'Authorization: OAuth token' \
    --data-binary '{
      "allowList": [
        "77.88.21.249",
        "77.88.54.0/23",
        "2a02:6b8::/32"
      ]
    }'

HTTP-запрос

POST https://api360.yandex.net/admin/v1/org/{orgId}/mail/antispam/allowlist/ips

Path-параметры

orgId *

integer

Идентификатор организации.

orgId *

integer

Идентификатор организации.

Тело запроса

{
  "allowList": [
    "string"
  ]
}
Скопировано

Представление

Свернуть всё
Развернуть всё

Поля

allowList[] *

array

Список разрешенных IP-адресов и CIDR-подсетей.
Примеры элементов списка: "77.88.21.249", "77.88.54.0/23", "2a02:6b8::/32".

allowList[] *

array

Список разрешенных IP-адресов и CIDR-подсетей.
Примеры элементов списка: "77.88.21.249", "77.88.54.0/23", "2a02:6b8::/32".

Ответы

Код 200

Запрос успешно выполнен.

{}
Скопировано

Представление

Свернуть всё
Развернуть всё

Поля

Код 401

Пользователь не авторизован.

{
  "code": integer,
  "details": [
    {
      "@type": string
    }
  ],
  "message": string
}
Скопировано

Представление

Свернуть всё
Развернуть всё

Поля

code

integer

Код ошибки.

details[]

array

Дополнительные сведения об ошибке.

details[].@type

string

message

string

Описание ошибки.

code

integer

Код ошибки.

details[]

array

Дополнительные сведения об ошибке.

details[].@type

string

message

string

Описание ошибки.

Код 403

У пользователя или приложения нет прав на доступ к ресурсу, запрос отклонен.

{
  "code": integer,
  "details": [
    {
      "@type": string
    }
  ],
  "message": string
}
Скопировано

Представление

Свернуть всё
Развернуть всё

Поля

code

integer

Код ошибки.

details[]

array

Дополнительные сведения об ошибке.

details[].@type

string

message

string

Описание ошибки.

code

integer

Код ошибки.

details[]

array

Дополнительные сведения об ошибке.

details[].@type

string

message

string

Описание ошибки.

Код 404

Запрашиваемый ресурс не найден.

{
  "code": integer,
  "details": [
    {
      "@type": string
    }
  ],
  "message": string
}
Скопировано

Представление

Свернуть всё
Развернуть всё

Поля

code

integer

Код ошибки.

details[]

array

Дополнительные сведения об ошибке.

details[].@type

string

message

string

Описание ошибки.

code

integer

Код ошибки.

details[]

array

Дополнительные сведения об ошибке.

details[].@type

string

message

string

Описание ошибки.

Код 500

Внутренняя ошибка сервиса. Попробуйте повторно отправить запрос через некоторое время.

{
  "code": integer,
  "details": [
    {
      "@type": string
    }
  ],
  "message": string
}
Скопировано

Представление

Свернуть всё
Развернуть всё

Поля

code

integer

Код ошибки.

details[]

array

Дополнительные сведения об ошибке.

details[].@type

string

message

string

Описание ошибки.

code

integer

Код ошибки.

details[]

array

Дополнительные сведения об ошибке.

details[].@type

string

message

string

Описание ошибки.