Задать список правил

Создает или обновляет список правил обработки писем.

Примечание

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

Request

PUT

https://api360.yandex.net/admin/v1/org/{orgId}/mail/routing/rules

Path parameters

Name

Description

orgId*

Type: integer<int64>

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

Body

application/json

{
    "rules": [
        {
            "condition": {
                "address:from": "spam@example.com"
            },
            "actions": {
                "action": "drop"
            },
            "scope": {
                "direction": "inbound"
            },
            "terminal": true
        }
    ]
}

Name

Description

rules

Type: v1RuleParams[]

Список правил обработки писем.

v1RuleParams

Name	Description
actions	Type: v1RuleActionParams[] Действия, которые необходимо выполнить при срабатывании правила.
condition	Type: any Условие (составное условие), которое проверяет соответствие письма текущему правилу. Подробное описание параметра.
scope	Type: v1RuleScopeParams Параметр, который задает область применения правила.
terminal	Type: boolean Признак, который определяет нужно ли прекратить применение последующих правил при срабатывании данного.

v1RuleActionParams

Name

Description

action

Type: RuleActionParamsRuleAction

Действие над письмом.

Default: drop

Enum: drop, forward

data

Type: v1RuleActionData

Дополнительные данные для действия.

v1RuleScopeParams

Name

Description

direction

Type: RuleScopeParamsRuleDirection

Параметр, который задает, будет ли применяться правило для входящей или для исходящей почты.

Default: inbound

Enum: inbound, outbound

RuleActionParamsRuleAction

drop: не доставлять письмо получателю — удалить входящее письмо или не производить отправку исходящего.
forward: переслать письмо на адрес, заданный в параметре email.

Type

Description

RuleActionParamsRuleAction

Default: drop

Enum: drop, forward

v1RuleActionData

Name

Description

Type: string

Адрес, на который нужно переслать письмо. Используется, если параметр action имеет значение forward.

RuleScopeParamsRuleDirection

inbound: правило должно применяться для входящей почты.
outbound: правило должно применяться для исходящей почты.

Type

Description

RuleScopeParamsRuleDirection

Default: inbound

Enum: inbound, outbound

Responses

200 OK

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

Body

application/json

{}

400 Bad Request

Некорректный запрос.

Body

application/json

{
    "code": 0,
    "message": "string",
    "details": [
        null
    ]
}

Name	Description
code	Type: integer<int32> Код ошибки.
details	Type: any[] Дополнительные сведения об ошибке.
message	Type: string Описание ошибки.

401 Unauthorized

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

Body

application/json

{
    "code": 0,
    "message": "string",
    "details": [
        null
    ]
}

Name	Description
code	Type: integer<int32> Код ошибки.
details	Type: any[] Дополнительные сведения об ошибке.
message	Type: string Описание ошибки.

403 Forbidden

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

Body

application/json

{
    "code": 0,
    "message": "string",
    "details": [
        null
    ]
}

Name	Description
code	Type: integer<int32> Код ошибки.
details	Type: any[] Дополнительные сведения об ошибке.
message	Type: string Описание ошибки.

404 Not Found

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

Body

application/json

{
    "code": 0,
    "message": "string",
    "details": [
        null
    ]
}

Name	Description
code	Type: integer<int32> Код ошибки.
details	Type: any[] Дополнительные сведения об ошибке.
message	Type: string Описание ошибки.

500 Internal Server Error

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

Body

application/json

{
    "code": 0,
    "message": "string",
    "details": [
        null
    ]
}

Name	Description
code	Type: integer<int32> Код ошибки.
details	Type: any[] Дополнительные сведения об ошибке.
message	Type: string Описание ошибки.

Была ли статья полезна?

Просмотреть список правил

Обзор