Show/Hide Toolbars

Руководство администратора

Описание методов в swagger

Ссылки Назад Вверх Вперед

Для работы с объектами используются следующие методы:

GET — для получения данных.

POST — для добавления данных.

PUT — для изменения данных.

DELETE — для удаления данных.

warning_icon  API веб-сервиса "Первой Формы" можно посмотреть, добавив в браузере к адресу вашего приложения "Первая Форма" строку /swagger:
https://<your_1forma>/swagger

Порядок действий:

1. Найдите нужный объект в общем списке объектов.

2. Найдите нужный метод объекта.

3. Заполните параметры метода, если они есть. Если для параметра есть схема, то по щелчку на поле со схемой она будет скопирована в поле со значением параметра. В эту схему подставьте правильные значения (см. пример ниже).

ws_api_1

Порядок работы с методом объекта (1-ая часть).

hmtoggle_arrow0Пример заполнения параметра для создания задачи

4. Когда все параметры заполнены, нажмите на кнопку "Try it out!".

5. Ниже будет сформирован адрес (URL) для вызова метода, а также отобразятся результаты вызова сервиса (например, номер созданной задачи и пр.), чтобы вы могли убедиться в правильности ваших настроек или проанализировать ошибки. В поле Response Code значение 200 означает корректное выполнение вызова, а 500 — ошибку.

ws_api_2

Порядок работы с методом объекта (2-ая часть).

warning_icon  Методы класса CommentsAdmin могут вызывать только пользователи, входящие в системную группу Administrators.

Наиболее используемые API методы

Agenda (Повестка дня)

old_icon Устаревшее. Больше не используется.

hmtoggle_arrow0 POST /api/agenda

Email

hmtoggle_arrow0 GET /api/emails/{emailId}

hmtoggle_arrow0 POST /api/emails/delete

Администрирование

hmtoggle_arrow0 GET /api/admin/forms/tree

Аутентификация

hmtoggle_arrow0 GET /api/auth/info

hmtoggle_arrow0 POST /api/auth/{userId}/impersonate

hmtoggle_arrow0 POST /api/auth/{userId}/stopimpersonate

hmtoggle_arrow0 POST /api/auth/token/refresh

 

Группы

hmtoggle_arrow0 GET /api/group/group-card

Задачи

hmtoggle_arrow0 GET /app/v1.0/api/subcategories/tree

hmtoggle_arrow0 GET /api/tasks

hmtoggle_arrow0 GET /api/tasks/{taskId}/actions

hmtoggle_arrow0 GET /app/v1.0/api/tasks/{taskId}/mainroute

hmtoggle_arrow0 GET /api/tasks/check-exist-and-access/{taskId}

hmtoggle_arrow0 GET /api/tasks/{taskId}/states

hmtoggle_arrow0 GET /api/task/avatar/{taskId}

hmtoggle_arrow0 GET /api/tasks/linked/{taskId}

hmtoggle_arrow0 GET /api/tasks/subtasks/removelink/{taskId}/{subtaskId}

hmtoggle_arrow0 POST /app/v1.2/api/tasks/feeds

hmtoggle_arrow0 POST /api/tasks/feedsBySP

hmtoggle_arrow0 POST /api/tasks

hmtoggle_arrow0 POST /api/tasks/create

hmtoggle_arrow0 POST /api/tasks/set-color

hmtoggle_arrow0 POST /api/tasks/delete

hmtoggle_arrow0 POST /api/tasks/{taskId}/set-priority

hmtoggle_arrow0 POST /api/tasks/{taskId}/lock-due-date

hmtoggle_arrow0 POST /api/tasks/{taskId}/unlock-due-date

hmtoggle_arrow0 POST /api/tasks/{taskId}/change-duedate

hmtoggle_arrow0 POST /api/tasks/{taskId}/change-subscribers

hmtoggle_arrow0 POST /api/tasks/{taskId}/remove-all-subscribers

hmtoggle_arrow0 POST /api/tasks/{taskId}/change-performers

hmtoggle_arrow0 POST /api/tasks/{taskId}/responsible-performer/{userId}

hmtoggle_arrow0 POST /api/tasks/{taskId}/pin-as-chat-to-all-users

hmtoggle_arrow0 POST /api/tasks/{taskId}/new-doc/{docType}

hmtoggle_arrow0 POST /api/tasks/{taskId}/responsible-performer/{userId}

hmtoggle_arrow0 POST /api/tasks/{taskId}/add-task-link

hmtoggle_arrow0 POST /api/tasks/change-owner

hmtoggle_arrow0 POST /api/tasks/{taskId}/changeState

hmtoggle_arrow0 POST /app/v1.0/api/tasks/template

hmtoggle_arrow0 POST /api/tasks/params/update

hmtoggle_arrow0 POST /api/task/actions/batch/smartbutton/smartbuttons

hmtoggle_arrow0 POST /api/task/files/history

hmtoggle_arrow0 POST /api/task/actions/batch/copy

ДП Таблица

hmtoggle_arrow0   GET /app/v1.2/api/ep/tableSettings/{tableId}/subcat/{subcatId}/{taskId}

hmtoggle_arrow0   GET /app/v1.2/api/admin/extparams/table/{tableExtParamId}/columns/{columnId}

hmtoggle_arrow0   POST /app/v1.2/api/task/{taskId}/ep/table/{tableId}/update

hmtoggle_arrow0   POST /app/v1.2/api/admin/extparams/table/{tableExtParamId}/columns/add

hmtoggle_arrow0   POST /app/v1.2/api/admin/extparams/table/{tableExtParamId}/columns/edit

hmtoggle_arrow0   POST /app/v1.2/api/admin/extparams/table/{tableExtParamId}/columns/delete

Избранное

hmtoggle_arrow0   GET /api/history/tasks

hmtoggle_arrow0   POST /api/favorite/addLink

hmtoggle_arrow0   POST /api/favorite/addFolder

hmtoggle_arrow0   POST /api/favorite/moveLink

hmtoggle_arrow0   POST /api/favorite/shareLink

hmtoggle_arrow0   POST /api/favorite/renameLink

hmtoggle_arrow0   POST /api/favorite/renameFolder

hmtoggle_arrow0   POST /api/favorite/updateIcon

hmtoggle_arrow0   POST /api/favorite/deleteLink

Индикаторы

hmtoggle_arrow0   GET /api/tickers/all

hmtoggle_arrow0   GET /api/tickers/custom

hmtoggle_arrow0   GET /api/tickers/system

hmtoggle_arrow0   GET /api/tickers/systemNames

История

hmtoggle_arrow0   GET /api/history/tasks

hmtoggle_arrow0   GET /api/history/employees

Календарь

hmtoggle_arrow0   GET /api/calendar/userConfig

hmtoggle_arrow0   GET /api/calendar/get

hmtoggle_arrow0   GET /api/calendar/attachment

hmtoggle_arrow0   GET /api/calendar/all-attachments

hmtoggle_arrow0   GET /api/calendar/permissions

hmtoggle_arrow0   GET /api/calendar/resolveName

hmtoggle_arrow0   GET /api/calendar/events

hmtoggle_arrow0   GET /app/v1.2/api/calendar/nonworkingdays

hmtoggle_arrow0   GET /app/v1.2/api/calendar/menuItems

hmtoggle_arrow0   GET /app/v1.2/api/calendar/nonworkingdaysandpreholidays

hmtoggle_arrow0   POST /api/calendar/action

hmtoggle_arrow0   POST /api/calendar/messages

hmtoggle_arrow0   POST /api/calendar/messages/unread/count

hmtoggle_arrow0   POST /api/calendar/create

hmtoggle_arrow0   POST /app/v1.2/api/calendar/isWorkingDateTime

hmtoggle_arrow0   POST /api/calendar/messages

hmtoggle_arrow0   DELETE /api/calendar/delete

hmtoggle_arrow0   PUT /api/calendar/update

Комментарии

hmtoggle_arrow0   GET /app/v1.2/api/mobile/comments/{commentId}/likedby

hmtoggle_arrow0   GET /api/comments/recipients/{commentId}/{searchInArchiveIfNotFound}

hmtoggle_arrow0   POST /api/comments/lenta

hmtoggle_arrow0   POST /api/comments/add

hmtoggle_arrow0   POST /api/comments/delete

hmtoggle_arrow0   POST /api/comments/previous-task-comments

hmtoggle_arrow0   POST /api/comments/mark-as-question/{commentId}

hmtoggle_arrow0   POST /api/comments/mark-comments-as-read

hmtoggle_arrow0   POST /api/comments/mark-as-not-my-question/{commentId}

hmtoggle_arrow0   POST /api/comments/mark-as-answered

hmtoggle_arrow0   POST /app/v1.2/api/mobile/comments/{commentId}/edit

hmtoggle_arrow0   POST /app/v1.2/api/mobile/comments/{commentId}/like

hmtoggle_arrow0   POST /app/v1.2/api/mobile/comments/{commentId}/unlike

hmtoggle_arrow0   POST /api/tasks/set-color

Локализация

hmtoggle_arrow0   GET /api/languages

hmtoggle_arrow0   GET /api/languages/user

hmtoggle_arrow0   GET /api/languages/default

МП

hmtoggle_arrow0 GET /app/v1.2/api/mobile/tasks/{taskId}

hmtoggle_arrow0 POST /app/v1.2/api/mobile/tasks/{taskId}/pin

hmtoggle_arrow0 POST /app/v1.2/api/mobile/tasks/{taskId}/unpin

hmtoggle_arrow0   POST /api/mobile-app/settings/update

hmtoggle_arrow0   POST /api/mobile-app/send-link-to-email

Орг.структура

hmtoggle_arrow0 GET /api/org-structure/card

Подписи

hmtoggle_arrow0 GET /api/signatures/dynamic/{signatureId}/acceptors

hmtoggle_arrow0 GET /api/signatures/dynamic

hmtoggle_arrow0 GET /api/storage/signatures/{id}

hmtoggle_arrow0 GET /api/storage/signatures

hmtoggle_arrow0 POST /api/signatures/dynamic/request

Пользователи

hmtoggle_arrow0   GET /api/user/{userId}/info

hmtoggle_arrow0   GET /api/user/settings

hmtoggle_arrow0   GET /api/user/{userId}/info

hmtoggle_arrow0   GET /api/user/process-assistants/{userId}

hmtoggle_arrow0   GET /api/user/assistants/restrictions/{assistanceId}

hmtoggle_arrow0   POST /api/user/change-password

hmtoggle_arrow0   POST /api/user/password-recovery

hmtoggle_arrow0   POST /api/user/{userId}/language

hmtoggle_arrow0   POST /api/user/coworkers

hmtoggle_arrow0   POST /api/user/change-password

hmtoggle_arrow0   POST /api/admin/user/notifications/{userId}/subcategory-flag

hmtoggle_arrow0   POST /api/user/search

hmtoggle_arrow0   POST /api/user/{userId}/ui-settings

hmtoggle_arrow0   POST /api/user/short-info

hmtoggle_arrow0   POST /api/users/status

hmtoggle_arrow0   POST /api/user/process-assistants/add

hmtoggle_arrow0   POST /api/user/process-assistants/remove

hmtoggle_arrow0   POST /api/user/assistants/add

hmtoggle_arrow0   POST /api/user/assistants/restrictions/add

hmtoggle_arrow0   POST /api/user/assistants/restrictions/remove/{assistanceId}

Портал

hmtoggle_arrow0   POST /api/portals/block/data/{blockId}

Права групп на группы, категории, разделы

hmtoggle_arrow0   GET /api/admin/permissions/{entityType}/{entityId}/actions

hmtoggle_arrow0   GET /api/admin/permissions/{entityType}/{entityId}

hmtoggle_arrow0   POST /api/admin/permissions/{entityType}/{entityId}/set

Срок задачи

hmtoggle_arrow0 GET /app/v1.2/api/tasks/{taskId}/duadate

hmtoggle_arrow0 GET /app/v1.2/api/tasks/{taskId}/duedate/history

hmtoggle_arrow0 POST /app/v1.2/api/tasks/duedate

Трудозатраты

hmtoggle_arrow0   POST /api/resource-facts

hmtoggle_arrow0   POST /api/resource-facts/approve

hmtoggle_arrow0   POST /api/resource-facts/unapprove

Файлы

hmtoggle_arrow0   GET /app/v1.2/api/filestorage/file/{fileId}/version

hmtoggle_arrow0   GET /app/v1.2/api/filestorage/file/{fileId}/info

hmtoggle_arrow0   GET /app/v1.2/api/filestorage/file/{fileId}/neighbours

hmtoggle_arrow0   GET /api/files/thumbnails/{fileId}/{versionId}

hmtoggle_arrow0   POST /api/files/import/exceltodb

hmtoggle_arrow0   POST /api/files/preupload/base64

hmtoggle_arrow0   POST /api/files/upload/FileToTask

hmtoggle_arrow0   POST /api/files/upload/{uploadType}

hmtoggle_arrow0   POST /api/task/files

hmtoggle_arrow0   POST /app/v1.2/api/files/delete/{fileId}/task/{taskId}/{forced}/{silent}

hmtoggle_arrow0   POST /api/task/files/pin/{taskId}/{fileId}

hmtoggle_arrow0   POST /api/task/files/unpin/{taskId}/{fileId}

Чаты

hmtoggle_arrow0   GET /api/chats

hmtoggle_arrow0   POST /app/v1.2/api/chats/{chatId}/setNotificationMode/{notificationMode}

hmtoggle_arrow0   POST /api/chats

hmtoggle_arrow0   POST /api/chats/left/{taskId}

hmtoggle_arrow0   POST /api/chats/close/{taskId}