Создать список приложений

  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. Поля

Создает или заменяет список сервисных приложений в организации.

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

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

  • cloud_api:disk.app_folder,
  • cloud_api:disk.read,
  • cloud_api:disk.write,
  • cloud_api:disk.info,
  • yadisk:disk,
  • calendar:all,
  • mail:imap_full,
  • mail:imap_ro,
  • mail:smtp,
  • telemost-api:conferences.create,
  • telemost-api:conferences.read,
  • telemost-api:conferences.update,
  • telemost-api:conferences.delete.

Пример:

curl https://api360.yandex.net/security/v1/org/100500/service_applications \
    --data-binary '{
      "applications": [
        {"id": "client_id...", "scopes":["cloud_api:disk.read","calendar:all"]},
        {"id": "client_id2...", "scopes":["mail:imap_full","yadisk:disk"]}
      ]
    }'

HTTP-запрос

POST https://api360.yandex.net/security/v1/org/{orgId}/service_applications

Path-параметры

orgId *

integer

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

orgId *

integer

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

Тело запроса

{
  "applications": [
    {
      "id": string,
      "scopes": [
        string
      ]
    }
  ]
}
Скопировано

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

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

Поля

applications[] *

array

Список сервисных приложений.

applications[].id *

string

Идентификатор приложения.

applications[].scopes[] *

array

Список доступов приложения.

applications[] *

array

Список сервисных приложений.

applications[].id *

string

Идентификатор приложения.

applications[].scopes[] *

array

Список доступов приложения.

Ответы

Код 200

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

{
  "applications": [
    {
      "id": string,
      "scopes": [
        string
      ]
    }
  ]
}
Скопировано

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

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

Поля

applications[] *

array

Список сервисных приложений.

applications[].id *

string

Идентификатор приложения.

applications[].scopes[] *

array

Список доступов приложения.

applications[] *

array

Список сервисных приложений.

applications[].id *

string

Идентификатор приложения.

applications[].scopes[] *

array

Список доступов приложения.

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