Вопросы и ответы - что такое Авторизация для Worksection API? Помощь пользователям информационной системы управления бизнес процессами

Доступ к Worksection API может осуществляться через:

админский токен
*предоставляет максимальные права
пользовательский токен (oauth2 токен доступа)
*предоставляет ограниченные права (согласно роли пользователя и разрешений приложения)

Админский токен

Используется следующий базовый URL:

https://youraccount.worksection.com/api/admin/v2/

Админский токен формируется в формате MD5 из списка всех параметров, используемых в запросе, и административного API ключа аккаунта (см. пример ниже).

Пример для метода get_tasks

?action=get_tasks&id_project=26

Формирование токена (на PHP)

$query_params = 'action=get_tasks&id_project=26';
$api_key = '7776461cd931e7b1c8e9632ff8e979ce';

$hash = md5($query_params.$apikey);

Итоговый запрос

https://youraccount.worksection.com/api/admin/v2/?action=get_tasks&
id_project=26&hash=ec3ab2c28f21b4a07424f8ed688d6644

Пользовательский токен

*oauth2 токен доступа

Используется следующий базовый URL:

https://youraccount.worksection.com/api/oauth2

Токен доступа можно сформировать через специальный запрос (см. детальнее). Действителен на протяжении 24-х часов. Далеe необходимо обновить его с помощью отдельного токена (refresh token) или сформировать новый.

Пример для метода get_tasks

?action=get_tasks&id_project=26

Итоговый запрос
*через header авторизации

curl -X GET -H "Authorization: Bearer <token_value>"
https://youraccount.worksection.com/api/oauth2?action=get_tasks&id_project=26

*через параметр access_token

https://youraccount.worksection.com/api/oauth2?action=get_tasks&id_project=26&
access_token=<token_value>