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

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

Примечание

Чтобы выполнить запрос, вашему 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 --request POST https://api360.yandex.net/security/v1/org/{orgId}/service_applications \
    --header 'Authorization: OAuth token' \
    --data-binary '{
      "applications": [
        {"id": "client_id...", "scopes":["cloud_api:disk.read","calendar:all"]},
        {"id": "client_id2...", "scopes":["mail:imap_full","yadisk:disk"]}
      ]
    }'

Request

POST

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

Path parameters

Name

Description

orgId*

Type: integer<int64>

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

Body

application/json
{
    "applications": [
        {
            "id": "string",
            "scopes": [
                "string"
            ]
        }
    ]
}

Name

Description

applications*

Type: v1ServiceApplication[]

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

v1ServiceApplication

Name

Description

id*

Type: string

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

scopes*

Type: string[]

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

Responses

200 OK

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

Body

application/json
{
    "applications": [
        {
            "id": "string",
            "scopes": [
                "string"
            ]
        }
    ]
}

Name

Description

applications*

Type: v1ServiceApplication[]

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

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

Описание ошибки.
Предыдущая
Очистить список приложений
Следующая
Активировать функцию