Requirements
Authentication
The following information is required to access the Wise Rest-API:
| Information | Description |
|---|---|
| ApplicationName | Name of application |
| API-ID | ID of application |
| API-KEY | Key of application to calculate the WISE-KEY |
The above information is published by OCLC. Using this data, a WISE-KEY must be calculated. This WISE-KEY must be included with every request and is provided in ‘WISE_KEY’ (underscore).
The API-ID is linked to the ApplicationName, and is the same on all environments and Wise installations. The API-KEY is unique per Wise system, and differs between PROD and all TEST/ACCEPT environments.
For the endpoints in the shared domain, it is also necessary to log in with a username/password combination. This login generates an authentication token. This token is also sent with the requests.
Permissions
To use the API, it is sometimes necessary to create a user with specific permissions (see above). This user can be created in the Manager just like a normal Client login. Most permissions are mentioned in the documentation with the used endpoint. If permission is needed on the organizational (instance) level, you will need to create the role on one of the branches of that organization. That will allow access to the branches of the related organization. Do not create multiple roles, as the Rest-API is unable to select a role.