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

  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/{actorId}/resources

Path-параметры

orgId *

integer

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

actorId *

string

Идентификатор сотрудника, для которого запрашивается список доступных ящиков.

orgId *

integer

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

actorId *

string

Идентификатор сотрудника, для которого запрашивается список доступных ящиков.

Ответы

Код 200

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

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

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

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

Поля

resources[]

array

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

resources[].resourceId

string

Идентификатор владельца почтового ящика.

resources[].rights[] *

array

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

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

resources[]

array

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

resources[].resourceId

string

Идентификатор владельца почтового ящика.

resources[].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