Перейти к содержанию

База знаний

API методы для модуля wiki

Разделы

Получение списка

GET /wiki/api/space/list

Метод позволяет получить все доступны разделы.

curl 'https://{HOST}.platrum.ru/wiki/api/space/list' \
    --request POST \
    --header 'Content-type: application/json' \ 
    --header 'Api-key: {KEY}'

{
    "status": "success",
    "data": [
        {
            "id": 123,
            "title": "some_string",
            "slug": "some_string",
            "is_archived": true,
            "is_public": true,
            "icon": "some_string",
            "creation_date": "2019-01-01 21:00:15",
            "modification_date": "2019-01-01 21:00:15",
            "description": "some_string",
            "home_article_id": 123,
            "order": 123,
            "access": [
                {
                    "id": 123,
                    "type": "some_string",
                    "block_id": 123,
                    "nested": true,
                    "parents": true
                }
            ],
            "access_edit": [
                {
                    "id": 123,
                    "type": "some_string",
                    "block_id": 123,
                    "nested": true,
                    "parents": true
                }
            ],
            "access_rules": [
                {
                    "id": 123,
                    "action": "some_string",
                    "user_id": "some_string",
                    "block_id": 123,
                    "allow_nested": true,
                    "allow_everyone": true,
                    "allow_managers": true,
                    "inherit_from_parents": true
                }
            ]
        },
        {
            "id": 123,
            "title": "some_string",
            "slug": "some_string",
            "is_archived": true,
            "is_public": true,
            "icon": "some_string",
            "creation_date": "2019-01-01 21:00:15",
            "modification_date": "2019-01-01 21:00:15",
            "description": "some_string",
            "home_article_id": 123,
            "order": 123,
            "access": [
                {
                    "id": 123,
                    "type": "some_string",
                    "block_id": 123,
                    "nested": true,
                    "parents": true
                }
            ],
            "access_edit": [
                {
                    "id": 123,
                    "type": "some_string",
                    "block_id": 123,
                    "nested": true,
                    "parents": true
                }
            ],
            "access_rules": [
                {
                    "id": 123,
                    "action": "some_string",
                    "user_id": "some_string",
                    "block_id": 123,
                    "allow_nested": true,
                    "allow_everyone": true,
                    "allow_managers": true,
                    "inherit_from_parents": true
                }
            ]
        }
    ]
}

Без параметров.

Параметр Описание Тип Значения
id ID int -
title Заголовок string -
slug Человекочитаемый URL string -
is_archived Статус архивации bool -
is_public Статус публичности bool -
icon Иконка string -
creation_date Дата создания date -
modification_date Дата последнего изменения date -
description Описание string -
home_article_id ID домашей страницы int -
order Сортировка int -
access Должности, которые могут просматривать раздел array[orgschema.access_item] -
access_edit Должности, которые могут редактировать раздел array[orgschema.access_item] -
access_rules array[permission.rule] -

Создание и обновление

POST /wiki/api/space/save

Метод позволяет создать новый раздел или изменить существующий.

curl 'https://{HOST}.platrum.ru/wiki/api/space/save' \
    --request POST \
    --header 'Content-type: application/json' \ 
    --header 'Api-key: {KEY}' \ 
    --data '{"id":123,"title":"some_string","slug":"some_string","is_archived":true,"is_public":true,"icon":"some_string","creation_date":"2019-01-01 21:00:15","modification_date":"2019-01-01 21:00:15","description":"some_string","home_article_id":123,"order":123,"access":[{"id":123,"type":"some_string","block_id":123,"nested":true,"parents":true}],"access_edit":[{"id":123,"type":"some_string","block_id":123,"nested":true,"parents":true}],"access_rules":[{"id":123,"action":"some_string","user_id":"some_string","block_id":123,"allow_nested":true,"allow_everyone":true,"allow_managers":true,"inherit_from_parents":true}]}'

{
    "status": "success",
    "data": {
        "id": 123,
        "title": "some_string",
        "slug": "some_string",
        "is_archived": true,
        "is_public": true,
        "icon": "some_string",
        "creation_date": "2019-01-01 21:00:15",
        "modification_date": "2019-01-01 21:00:15",
        "description": "some_string",
        "home_article_id": 123,
        "order": 123,
        "access": [
            {
                "id": 123,
                "type": "some_string",
                "block_id": 123,
                "nested": true,
                "parents": true
            }
        ],
        "access_edit": [
            {
                "id": 123,
                "type": "some_string",
                "block_id": 123,
                "nested": true,
                "parents": true
            }
        ],
        "access_rules": [
            {
                "id": 123,
                "action": "some_string",
                "user_id": "some_string",
                "block_id": 123,
                "allow_nested": true,
                "allow_everyone": true,
                "allow_managers": true,
                "inherit_from_parents": true
            }
        ]
    }
}
Параметр Описание Тип Значения
id ID int -
title Заголовок string -
slug Человекочитаемый URL string -
is_archived Статус архивации bool -
is_public Статус публичности bool -
icon Иконка string -
creation_date Дата создания date -
modification_date Дата последнего изменения date -
description Описание string -
home_article_id ID домашей страницы int -
order Сортировка int -
access Должности, которые могут просматривать раздел array[orgschema.access_item] -
access_edit Должности, которые могут редактировать раздел array[orgschema.access_item] -
access_rules array[permission.rule] -
Параметр Описание Тип Значения
id ID int -
title Заголовок string -
slug Человекочитаемый URL string -
is_archived Статус архивации bool -
is_public Статус публичности bool -
icon Иконка string -
creation_date Дата создания date -
modification_date Дата последнего изменения date -
description Описание string -
home_article_id ID домашей страницы int -
order Сортировка int -
access Должности, которые могут просматривать раздел array[orgschema.access_item] -
access_edit Должности, которые могут редактировать раздел array[orgschema.access_item] -
access_rules array[permission.rule] -

Удаление

POST /wiki/api/space/archive

Метод позволяет скрыть раздел для всех пользователей, сделав его доступным только администратору базы знаний. Все статьи раздела при этом будут удалены.

curl 'https://{HOST}.platrum.ru/wiki/api/space/archive' \
    --request POST \
    --header 'Content-type: application/json' \ 
    --header 'Api-key: {KEY}' \ 
    --data '{"id":123}'

{
    "status": "success",
    "data": true
}
Параметр Описание Тип Значения
id* ID раздела int -

bool

Статьи

Получение списка

GET /wiki/api/article/list

Метод позволяет получить все доступные статьи одного или всех разделов.

curl 'https://{HOST}.platrum.ru/wiki/api/article/list' \
    --request POST \
    --header 'Content-type: application/json' \ 
    --header 'Api-key: {KEY}' \ 
    --data '{"space_id":123}'

{
    "status": "success",
    "data": [
        {
            "id": 123,
            "space_ids": [
                123,
                123
            ],
            "title": "some_string",
            "slug": "some_string",
            "is_draft": true,
            "content_blocks": [
                {
                    "id": 123,
                    "type": "some_string",
                    "content": "some_string",
                    "name": "some_string",
                    "key": "some_string",
                    "size": "some_string",
                    "level": 123,
                    "sequence_index": 123,
                    "options": "map"
                }
            ],
            "parent_ids": [
                123,
                123
            ],
            "author_id": "some_string",
            "creation_date": "2019-01-01 21:00:15",
            "modification_date": "2019-01-01 21:00:15",
            "last_editor_id": "some_string",
            "access": [
                {
                    "id": 123,
                    "type": "some_string",
                    "block_id": 123,
                    "nested": true,
                    "parents": true
                }
            ],
            "access_edit": [
                {
                    "id": 123,
                    "type": "some_string",
                    "block_id": 123,
                    "nested": true,
                    "parents": true
                }
            ],
            "access_comment": [
                {
                    "id": 123,
                    "type": "some_string",
                    "block_id": 123,
                    "nested": true,
                    "parents": true
                }
            ],
            "orders": "array",
            "view_count": 123,
            "viewed_user_ids": [
                "some_string",
                "some_string"
            ],
            "appearance": "map",
            "access_rules": [
                {
                    "id": 123,
                    "action": "some_string",
                    "user_id": "some_string",
                    "block_id": 123,
                    "allow_nested": true,
                    "allow_everyone": true,
                    "allow_managers": true,
                    "inherit_from_parents": true
                }
            ]
        },
        {
            "id": 123,
            "space_ids": [
                123,
                123
            ],
            "title": "some_string",
            "slug": "some_string",
            "is_draft": true,
            "content_blocks": [
                {
                    "id": 123,
                    "type": "some_string",
                    "content": "some_string",
                    "name": "some_string",
                    "key": "some_string",
                    "size": "some_string",
                    "level": 123,
                    "sequence_index": 123,
                    "options": "map"
                }
            ],
            "parent_ids": [
                123,
                123
            ],
            "author_id": "some_string",
            "creation_date": "2019-01-01 21:00:15",
            "modification_date": "2019-01-01 21:00:15",
            "last_editor_id": "some_string",
            "access": [
                {
                    "id": 123,
                    "type": "some_string",
                    "block_id": 123,
                    "nested": true,
                    "parents": true
                }
            ],
            "access_edit": [
                {
                    "id": 123,
                    "type": "some_string",
                    "block_id": 123,
                    "nested": true,
                    "parents": true
                }
            ],
            "access_comment": [
                {
                    "id": 123,
                    "type": "some_string",
                    "block_id": 123,
                    "nested": true,
                    "parents": true
                }
            ],
            "orders": "array",
            "view_count": 123,
            "viewed_user_ids": [
                "some_string",
                "some_string"
            ],
            "appearance": "map",
            "access_rules": [
                {
                    "id": 123,
                    "action": "some_string",
                    "user_id": "some_string",
                    "block_id": 123,
                    "allow_nested": true,
                    "allow_everyone": true,
                    "allow_managers": true,
                    "inherit_from_parents": true
                }
            ]
        }
    ]
}
Параметр Описание Тип Значения
space_id ID Раздела int -
Параметр Описание Тип Значения
id ID int -
space_ids ID раздела. На данный момент осуществляется поддержка только одного раздела. array[int] -
title Заголовок string -
slug Человекочитаемый URL string -
is_draft Статус публикации bool -
content_blocks Контент блоки array[wiki.content_block] -
parent_ids ID родителя. На данный момент осуществляется поддержка только одного родителя. array[int] -
author_id ID автора string -
creation_date Дата создания date -
modification_date Дата последнего изменения date -
last_editor_id Id последнего редактора string -
access Должности, которые могут просматривать статью array[orgschema.access_item] -
access_edit Должности, которые могут редактировать статью array[orgschema.access_item] -
access_comment Должности, которые могут комментировать статью array[orgschema.access_item] -
orders Сортировка array -
view_count Количество просмотров int -
viewed_user_ids ID просмотревших пользователей array[string] -
appearance Обложка статьи map -
access_rules array[permission.rule] -

Получение

GET /wiki/api/article/get

Метод позволяет получить статью по её ID.

curl 'https://{HOST}.platrum.ru/wiki/api/article/get' \
    --request POST \
    --header 'Content-type: application/json' \ 
    --header 'Api-key: {KEY}' \ 
    --data '{"id":123}'

{
    "status": "success",
    "data": {
        "id": 123,
        "space_ids": [
            123,
            123
        ],
        "title": "some_string",
        "slug": "some_string",
        "is_draft": true,
        "content_blocks": [
            {
                "id": 123,
                "type": "some_string",
                "content": "some_string",
                "name": "some_string",
                "key": "some_string",
                "size": "some_string",
                "level": 123,
                "sequence_index": 123,
                "options": "map"
            }
        ],
        "parent_ids": [
            123,
            123
        ],
        "author_id": "some_string",
        "creation_date": "2019-01-01 21:00:15",
        "modification_date": "2019-01-01 21:00:15",
        "last_editor_id": "some_string",
        "access": [
            {
                "id": 123,
                "type": "some_string",
                "block_id": 123,
                "nested": true,
                "parents": true
            }
        ],
        "access_edit": [
            {
                "id": 123,
                "type": "some_string",
                "block_id": 123,
                "nested": true,
                "parents": true
            }
        ],
        "access_comment": [
            {
                "id": 123,
                "type": "some_string",
                "block_id": 123,
                "nested": true,
                "parents": true
            }
        ],
        "orders": "array",
        "view_count": 123,
        "viewed_user_ids": [
            "some_string",
            "some_string"
        ],
        "appearance": "map",
        "access_rules": [
            {
                "id": 123,
                "action": "some_string",
                "user_id": "some_string",
                "block_id": 123,
                "allow_nested": true,
                "allow_everyone": true,
                "allow_managers": true,
                "inherit_from_parents": true
            }
        ]
    }
}
Параметр Описание Тип Значения
id* ID статьи int -
Параметр Описание Тип Значения
id ID int -
space_ids ID раздела. На данный момент осуществляется поддержка только одного раздела. array[int] -
title Заголовок string -
slug Человекочитаемый URL string -
is_draft Статус публикации bool -
content_blocks Контент блоки array[wiki.content_block] -
parent_ids ID родителя. На данный момент осуществляется поддержка только одного родителя. array[int] -
author_id ID автора string -
creation_date Дата создания date -
modification_date Дата последнего изменения date -
last_editor_id Id последнего редактора string -
access Должности, которые могут просматривать статью array[orgschema.access_item] -
access_edit Должности, которые могут редактировать статью array[orgschema.access_item] -
access_comment Должности, которые могут комментировать статью array[orgschema.access_item] -
orders Сортировка array -
view_count Количество просмотров int -
viewed_user_ids ID просмотревших пользователей array[string] -
appearance Обложка статьи map -
access_rules array[permission.rule] -

Создание и обновление

POST /wiki/api/article/save

Метод позовляет создать статью или изменить существующую.

curl 'https://{HOST}.platrum.ru/wiki/api/article/save' \
    --request POST \
    --header 'Content-type: application/json' \ 
    --header 'Api-key: {KEY}' \ 
    --data '{"id":123,"space_ids":[123,123],"title":"some_string","slug":"some_string","content_blocks":[{"id":123,"type":"some_string","content":"some_string","name":"some_string","key":"some_string","size":"some_string","level":123,"sequence_index":123,"options":"map"}],"parent_ids":[123,123],"last_editor_id":"some_string","access":[{"id":123,"type":"some_string","block_id":123,"nested":true,"parents":true}],"access_edit":[{"id":123,"type":"some_string","block_id":123,"nested":true,"parents":true}],"access_comment":[{"id":123,"type":"some_string","block_id":123,"nested":true,"parents":true}],"orders":"array","appearance":"map","access_rules":[{"id":123,"action":"some_string","user_id":"some_string","block_id":123,"allow_nested":true,"allow_everyone":true,"allow_managers":true,"inherit_from_parents":true}]}'

{
    "status": "success",
    "data": {
        "id": 123,
        "space_ids": [
            123,
            123
        ],
        "title": "some_string",
        "slug": "some_string",
        "is_draft": true,
        "content_blocks": [
            {
                "id": 123,
                "type": "some_string",
                "content": "some_string",
                "name": "some_string",
                "key": "some_string",
                "size": "some_string",
                "level": 123,
                "sequence_index": 123,
                "options": "map"
            }
        ],
        "parent_ids": [
            123,
            123
        ],
        "author_id": "some_string",
        "creation_date": "2019-01-01 21:00:15",
        "modification_date": "2019-01-01 21:00:15",
        "last_editor_id": "some_string",
        "access": [
            {
                "id": 123,
                "type": "some_string",
                "block_id": 123,
                "nested": true,
                "parents": true
            }
        ],
        "access_edit": [
            {
                "id": 123,
                "type": "some_string",
                "block_id": 123,
                "nested": true,
                "parents": true
            }
        ],
        "access_comment": [
            {
                "id": 123,
                "type": "some_string",
                "block_id": 123,
                "nested": true,
                "parents": true
            }
        ],
        "orders": "array",
        "view_count": 123,
        "viewed_user_ids": [
            "some_string",
            "some_string"
        ],
        "appearance": "map",
        "access_rules": [
            {
                "id": 123,
                "action": "some_string",
                "user_id": "some_string",
                "block_id": 123,
                "allow_nested": true,
                "allow_everyone": true,
                "allow_managers": true,
                "inherit_from_parents": true
            }
        ]
    }
}
Параметр Описание Тип Значения
id ID int -
space_ids ID раздела. На данный момент осуществляется поддержка только одного раздела. array[int] -
title Заголовок string -
slug Человекочитаемый URL string -
content_blocks Контент блоки array[wiki.content_block] -
parent_ids ID родителя. На данный момент осуществляется поддержка только одного родителя. array[int] -
last_editor_id Id последнего редактора string -
access Должности, которые могут просматривать статью array[orgschema.access_item] -
access_edit Должности, которые могут редактировать статью array[orgschema.access_item] -
access_comment Должности, которые могут комментировать статью array[orgschema.access_item] -
orders Сортировка array -
appearance Обложка статьи map -
access_rules array[permission.rule] -
Параметр Описание Тип Значения
id ID int -
space_ids ID раздела. На данный момент осуществляется поддержка только одного раздела. array[int] -
title Заголовок string -
slug Человекочитаемый URL string -
is_draft Статус публикации bool -
content_blocks Контент блоки array[wiki.content_block] -
parent_ids ID родителя. На данный момент осуществляется поддержка только одного родителя. array[int] -
author_id ID автора string -
creation_date Дата создания date -
modification_date Дата последнего изменения date -
last_editor_id Id последнего редактора string -
access Должности, которые могут просматривать статью array[orgschema.access_item] -
access_edit Должности, которые могут редактировать статью array[orgschema.access_item] -
access_comment Должности, которые могут комментировать статью array[orgschema.access_item] -
orders Сортировка array -
view_count Количество просмотров int -
viewed_user_ids ID просмотревших пользователей array[string] -
appearance Обложка статьи map -
access_rules array[permission.rule] -

Удаление

POST /wiki/api/article/delete

Метод позволяет удалить статью по её ID.

curl 'https://{HOST}.platrum.ru/wiki/api/article/delete' \
    --request POST \
    --header 'Content-type: application/json' \ 
    --header 'Api-key: {KEY}' \ 
    --data '{"id":123}'

{
    "status": "success",
    "data": true
}
Параметр Описание Тип Значения
id* ID статьи int -

bool

Получение списка версий

GET /wiki/api/article/versions

Метод позволяет получить список версий статьи по её ID.

curl 'https://{HOST}.platrum.ru/wiki/api/article/versions' \
    --request POST \
    --header 'Content-type: application/json' \ 
    --header 'Api-key: {KEY}' \ 
    --data '{"article_id":123}'

{
    "status": "success",
    "data": [
        {
            "id": 123,
            "article_id": 123,
            "title": "some_string",
            "content_blocks": [
                {
                    "id": 123,
                    "type": "some_string",
                    "content": "some_string",
                    "name": "some_string",
                    "key": "some_string",
                    "size": "some_string",
                    "level": 123,
                    "sequence_index": 123,
                    "options": "map"
                }
            ],
            "date": "2019-01-01 21:00:15",
            "author_id": "some_string"
        },
        {
            "id": 123,
            "article_id": 123,
            "title": "some_string",
            "content_blocks": [
                {
                    "id": 123,
                    "type": "some_string",
                    "content": "some_string",
                    "name": "some_string",
                    "key": "some_string",
                    "size": "some_string",
                    "level": 123,
                    "sequence_index": 123,
                    "options": "map"
                }
            ],
            "date": "2019-01-01 21:00:15",
            "author_id": "some_string"
        }
    ]
}
Параметр Описание Тип Значения
article_id* ID статьи int -
Параметр Описание Тип Значения
id ID int -
article_id ID статьи int -
title Заголовок статьи string -
content_blocks Контент блоки array[wiki.content_block] -
date Дата date -
author_id ID автора string -

Получение списка вопросов

GET /wiki/api/article/get-questions

Метод позволяет получить список вопросов статьи.

curl 'https://{HOST}.platrum.ru/wiki/api/article/get-questions' \
    --request POST \
    --header 'Content-type: application/json' \ 
    --header 'Api-key: {KEY}' \ 
    --data '{"article_id":123}'

{
    "status": "success",
    "data": {
        "id": 123,
        "article_id": 123,
        "title": "some_string",
        "type": "some_string",
        "is_exam": true,
        "points": 123,
        "variants": [
            {
                "id": 123,
                "name": "some_string",
                "value": "some_string",
                "is_valid": true
            }
        ],
        "is_file_required": true
    }
}
Параметр Описание Тип Значения
article_id* ID статьи int -
Параметр Описание Тип Значения
id ID int -
article_id ID статьи int -
title Текст вопроса string -
type Тип string variant/open
is_exam Является ли экзаменационным bool -
points Количество баллов за верный ответ int -
variants Варианты ответа array[wiki.question_variant] -
is_file_required bool -

Создание и обновление вопроса статьи

POST /wiki/api/article/save-question

Метод позволяет создать вопрос к статье или изменить существующий.

curl 'https://{HOST}.platrum.ru/wiki/api/article/save-question' \
    --request POST \
    --header 'Content-type: application/json' \ 
    --header 'Api-key: {KEY}' \ 
    --data '{"id":123,"article_id":123,"title":"some_string","type":"some_string","points":123,"variants":[{"id":123,"name":"some_string","value":"some_string","is_valid":true}]}'

{
    "status": "success",
    "data": [
        {
            "id": 123,
            "article_id": 123,
            "title": "some_string",
            "type": "some_string",
            "is_exam": true,
            "points": 123,
            "variants": [
                {
                    "id": 123,
                    "name": "some_string",
                    "value": "some_string",
                    "is_valid": true
                }
            ],
            "is_file_required": true
        },
        {
            "id": 123,
            "article_id": 123,
            "title": "some_string",
            "type": "some_string",
            "is_exam": true,
            "points": 123,
            "variants": [
                {
                    "id": 123,
                    "name": "some_string",
                    "value": "some_string",
                    "is_valid": true
                }
            ],
            "is_file_required": true
        }
    ]
}
Параметр Описание Тип Значения
id ID int -
article_id ID статьи int -
title Текст вопроса string -
type Тип string variant/open
points Количество баллов за верный ответ int -
variants Варианты ответа array[wiki.question_variant] -
Параметр Описание Тип Значения
id ID int -
article_id ID статьи int -
title Текст вопроса string -
type Тип string variant/open
is_exam Является ли экзаменационным bool -
points Количество баллов за верный ответ int -
variants Варианты ответа array[wiki.question_variant] -
is_file_required bool -

Курсы

Получение списка

GET /wiki/api/course/list

Метод позволяет получить список курсов.

curl 'https://{HOST}.platrum.ru/wiki/api/course/list' \
    --request POST \
    --header 'Content-type: application/json' \ 
    --header 'Api-key: {KEY}'

{
    "status": "success",
    "data": [
        {
            "id": 123,
            "title": "some_string",
            "description": "some_string",
            "cover_file_id": "some_string",
            "steps": [
                {
                    "id": "some_string",
                    "type": "some_string",
                    "article_id": 123,
                    "order": 123
                }
            ],
            "is_deleted": true,
            "access_blocks": [
                {
                    "id": 123,
                    "type": "some_string",
                    "block_id": 123,
                    "nested": true,
                    "parents": true
                }
            ],
            "blocks_assign_date": "map",
            "creation_date": "2019-01-01 21:00:15",
            "modification_date": "2019-01-01 21:00:15",
            "instructors": [
                "some_string",
                "some_string"
            ],
            "author_id": "some_string",
            "is_periodic": true,
            "categories": [
                {
                    "id": 123,
                    "category_key": "some_string",
                    "course_order": 123
                }
            ],
            "access_rules": [
                {
                    "id": 123,
                    "action": "some_string",
                    "user_id": "some_string",
                    "block_id": 123,
                    "allow_nested": true,
                    "allow_everyone": true,
                    "allow_managers": true,
                    "inherit_from_parents": true
                }
            ]
        },
        {
            "id": 123,
            "title": "some_string",
            "description": "some_string",
            "cover_file_id": "some_string",
            "steps": [
                {
                    "id": "some_string",
                    "type": "some_string",
                    "article_id": 123,
                    "order": 123
                }
            ],
            "is_deleted": true,
            "access_blocks": [
                {
                    "id": 123,
                    "type": "some_string",
                    "block_id": 123,
                    "nested": true,
                    "parents": true
                }
            ],
            "blocks_assign_date": "map",
            "creation_date": "2019-01-01 21:00:15",
            "modification_date": "2019-01-01 21:00:15",
            "instructors": [
                "some_string",
                "some_string"
            ],
            "author_id": "some_string",
            "is_periodic": true,
            "categories": [
                {
                    "id": 123,
                    "category_key": "some_string",
                    "course_order": 123
                }
            ],
            "access_rules": [
                {
                    "id": 123,
                    "action": "some_string",
                    "user_id": "some_string",
                    "block_id": 123,
                    "allow_nested": true,
                    "allow_everyone": true,
                    "allow_managers": true,
                    "inherit_from_parents": true
                }
            ]
        }
    ]
}

Без параметров.

Параметр Описание Тип Значения
id ID int -
title Название string -
description Описание string -
cover_file_id ID файла-обложки string -
steps Шаги курса array[wiki.course_step] -
is_deleted Является ли удаленным bool -
access_blocks Должности, которым назначен курс array[orgschema.access_item] -
blocks_assign_date Дата назначения курса каждой должности map -
creation_date Дата создания date -
modification_date Дата изменения date -
instructors ID инструкторов array[string] -
author_id ID автора string -
is_periodic Является ли автоматическим курсом контроля знаний bool -
categories Категории курса array[wiki.category_data] -
access_rules array[permission.rule] -

Создание

POST /wiki/api/course/save

Метод позволяет создать курс.

curl 'https://{HOST}.platrum.ru/wiki/api/course/save' \
    --request POST \
    --header 'Content-type: application/json' \ 
    --header 'Api-key: {KEY}' \ 
    --data '{"id":123,"title":"some_string","description":"some_string","cover_file_id":"some_string","steps":[{"id":"some_string","type":"some_string","article_id":123,"order":123}],"categories":[{"id":123,"category_key":"some_string","course_order":123}],"access_rules":[{"id":123,"action":"some_string","user_id":"some_string","block_id":123,"allow_nested":true,"allow_everyone":true,"allow_managers":true,"inherit_from_parents":true}]}'

{
    "status": "success",
    "data": {
        "id": 123,
        "title": "some_string",
        "description": "some_string",
        "cover_file_id": "some_string",
        "steps": [
            {
                "id": "some_string",
                "type": "some_string",
                "article_id": 123,
                "order": 123
            }
        ],
        "is_deleted": true,
        "access_blocks": [
            {
                "id": 123,
                "type": "some_string",
                "block_id": 123,
                "nested": true,
                "parents": true
            }
        ],
        "blocks_assign_date": "map",
        "creation_date": "2019-01-01 21:00:15",
        "modification_date": "2019-01-01 21:00:15",
        "instructors": [
            "some_string",
            "some_string"
        ],
        "author_id": "some_string",
        "is_periodic": true,
        "categories": [
            {
                "id": 123,
                "category_key": "some_string",
                "course_order": 123
            }
        ],
        "access_rules": [
            {
                "id": 123,
                "action": "some_string",
                "user_id": "some_string",
                "block_id": 123,
                "allow_nested": true,
                "allow_everyone": true,
                "allow_managers": true,
                "inherit_from_parents": true
            }
        ]
    }
}
Параметр Описание Тип Значения
id ID int -
title Название string -
description Описание string -
cover_file_id ID файла-обложки string -
steps Шаги курса array[wiki.course_step] -
categories Категории курса array[wiki.category_data] -
access_rules array[permission.rule] -
Параметр Описание Тип Значения
id ID int -
title Название string -
description Описание string -
cover_file_id ID файла-обложки string -
steps Шаги курса array[wiki.course_step] -
is_deleted Является ли удаленным bool -
access_blocks Должности, которым назначен курс array[orgschema.access_item] -
blocks_assign_date Дата назначения курса каждой должности map -
creation_date Дата создания date -
modification_date Дата изменения date -
instructors ID инструкторов array[string] -
author_id ID автора string -
is_periodic Является ли автоматическим курсом контроля знаний bool -
categories Категории курса array[wiki.category_data] -
access_rules array[permission.rule] -

Удаление

POST /wiki/api/course/delete

Метод позволяет удалить курс.

curl 'https://{HOST}.platrum.ru/wiki/api/course/delete' \
    --request POST \
    --header 'Content-type: application/json' \ 
    --header 'Api-key: {KEY}' \ 
    --data '{"id":123}'

{
    "status": "success",
    "data": true
}
Параметр Описание Тип Значения
id ID курса int -

bool