Worksection API authorization


To get access to Worksection API you can use:
  • admin token
    *grants highest rights
  • user token (oauth2 access token)
    *grants limited rights (according to user role and app permissions)

Admin token

Use next basic URL:
https://youraccount.worksection.com/api/admin/v2/
Admin token is generated in MD5 format from all request parameters and account administrative API key (example below).

Example for get_tasks method
?action=get_tasks&id_project=26
Getting token (on PHP)
$query_params = 'action=get_tasks&id_project=26';
$api_key = '7776461cd931e7b1c8e9632ff8e979ce';

$hash = md5($query_params.$apikey);
Final request
https://youraccount.worksection.com/api/admin/v2/?action=get_tasks&id_project=26&
hash=ec3ab2c28f21b4a07424f8ed688d6644

User token

*oauth2 access token
​​
​Use next basic URL:
https://youraccount.worksection.com/api/oauth2
Access token can be obtained by a special request (see details). It's valid for 24 hours. Then you need to refresh it with refresh_token or get a new one.

Example for get_tasks method
?action=get_tasks&id_project=26​
Final request
*with authorization header
curl -X GET -H "Authorization: Bearer <token_value>"
https://youraccount.worksection.com/api/oauth2?action=get_tasks&id_project=26
*with access_token parameter
https://youraccount.worksection.com/api/oauth2?action=get_tasks&id_project=26&
access_token=<token_value>