The MyWorkPal platform provides a RESTful API which can enable external applications to interface with the platform. To be able to make use of the API, an API client needs to be set up. An API client has the credentials and permissions for an external application to connect to the API. You are able to create API clients in the MyWorkPal admin portal (if your admin account has the necessary permissions). To do this, select the BackOffice > Users > API Clients menu:
You will be directed to the API Clients page where you will able to add, delete or update API clients.
To add a new API client, click the 'Add API Client' button. You will be presented with the following page:
You will be required to enter the following details:
| Client ID | The ID of the API client - effectively the username. This will be used by an external app along with secret to identify the API client they will be using when connecting to the API. |
| Client name | The name of the API Client, for display in the admin screens only. |
| Client secret | The secret/password of the API client. This will be used by an external app to authenticate the API client |
| Admin User | This will be the account that is impersonated by the API client. This account will need the necessary permissions for API end points to be accessible to the API client. IMPORTANT: This admin account should be set up with the least necessary privileges required by the API client. Remember that you could potentially give an external app full privileges to the platform so be mindful of the security risk. See How to create admin users to view how to set this account up with the relevant roles and permissions. |
| Custom throttling | This sets whether custom throttling will be implemented for this API client. If enabled, you are able to limit the number of requests an API Client can make to the API. You are able to limit request by second, minute, hour, day or week. Setting a value of 0 means unlimited. |
| Enabled | This sets if an API client is enabled or not. Only enabled API clients can be used to connect to the API. |
Click the 'Save API client' button to save the API client details. You will be returned to the API Clients list page.
You are able to add new API clients or edit/delete existing API Clients from this page.
Any enabled API clients will be available for use immediately.