URL: http://Host.port/api/v2/script_folders
Method: POST
Имя | Описание | Пример | |
---|---|---|---|
FolderCreateDescription | Параметры создаваемой папки | ||
"name": string, | название папки | "name":"s", | |
"description": string, | описание папки | "description":"", | |
"parent": string, | id родительской папки(00000000 - корень) | "parent":"00000000", | |
"visibility": Visibility | видимость папки:
| "visibility":"visible" |
HTTP-заголовки ответа | Описание |
---|---|
Location="/api/v2/script_folders/{folder_id}" | folder_id – ID созданной папки. |
Ответы | |
---|---|
201 | Сreated, путь до созданной папки в заголовке ответа Location: /api/v2/script_folders/:folder_id - папка создана успешно. |
303 | See other, путь до существующей папки в заголовке ответа Location: /api/v2/script_folders/:folder_id - по заданным параметрам в области (в корне или внутри папки, заданной в parent) уже есть папка с таким наименованием. |
400 | Bad request - некорректная структура запроса. |
401 | Unauthorized - текущий пользователь не авторизован. |
403 | Forbidden - текущему пользователю запрещено создавать конкретно такую папку (например, есть скрытая с таким |
404 | Not Found - родительская папка не найдена (если её идентификатор отличен от нулевого). |
409 | Conflict - создаваемая папка уже существует |
500 | Internal Server Error - внутренняя ошибка сервера |