Посмотреть список сотрудников, имеющих доступ к ящику

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

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

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

HTTP-запрос

GET https://api360.yandex.net/admin/v1/org/{orgId}/mail/delegated/{resourceId}/actors

Path-параметры

orgId *

integer

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

resourceId *

string

Идентификатор владельца почтового ящика, права доступа к которому необходимо проверить.

orgId *

integer

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

resourceId *

string

Идентификатор владельца почтового ящика, права доступа к которому необходимо проверить.

Ответы

Код 200

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

{
  "actors": [
    {
      "actorId": string,
      "rights": [
        string
      ]
    }
  ]
}
Скопировано

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

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

Поля

actors[]

array

Список сотрудников, у которых есть права доступа к почтовому ящику.

actors[].actorId

string

Идентификатор сотрудника.

actors[].rights[] *

array

Список прав доступа.
Возможные значения:

  • imap_full_access — право на чтение почты и управление настройками ящика по протоколу IMAP, возможности отправлять письма это право не дает.
  • send_on_behalf — возможность отправлять письма из ящика по протоколу SMTP от своего имени: в поле "От кого" в письме будет указан адрес настоящего отправителя.
  • send_as — возможность отправлять письма по протоколу SMTP от имени владельца ящика: в поле "От кого" в письме будет указан адрес владелеца.

actors[]

array

Список сотрудников, у которых есть права доступа к почтовому ящику.

actors[].actorId

string

Идентификатор сотрудника.

actors[].rights[] *

array

Список прав доступа.
Возможные значения:

  • imap_full_access — право на чтение почты и управление настройками ящика по протоколу IMAP, возможности отправлять письма это право не дает.
  • send_on_behalf — возможность отправлять письма из ящика по протоколу SMTP от своего имени: в поле "От кого" в письме будет указан адрес настоящего отправителя.
  • send_as — возможность отправлять письма по протоколу SMTP от имени владельца ящика: в поле "От кого" в письме будет указан адрес владелеца.

Код 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