There are currently two versions of the Project API available. This documentation will cover the latest version, Version 2.
Because this API is intended to be consumed by applications, a high standard of security is implemented.
- You may create one or more Applications in your account prior to using the API.
- Without doing so, access to the API will fail.
- An Application has a title (for reference), a Public API key, and a Secret key.
- An Application can have its permissions revoked at any time.
- Once an Application has been revoked, any calls to the API using its Public and Secret keys will fail.
- It is recommended that you create one Application for each third-party system you wish to grant access to.
- This allows you to easily manage permissions in the future.
- These Public and Secret Application keys are visible to you within the Elucidat platform.
Creating an application
Before using the API, you must create a set of keys that from part of the authentication requirements for the projects API.
In your Elucidat account, click the button in the top right, and select "API Access"
Next, click "Project API (v2)
This will take you to the Project API page within your account.
Give your application a name - we suggest using something that you will remember later on.
For example, "testingappDONTREMOVE1234" is not useful in the future as "Integration Test 2021", should you need to revoke the keys.
Once you've named your application, click "Add Application"
Your application will be added to the list of available applications, and the Public Key shown alongside the application name.
Your Secret Key
Your secret key for a given application isn't displayed alongside the Public Key for security reasons. It can instead be found in the automatically generated code examples you'll find in your account.
For example, at the bottom of the first example, you can see it next to your Public Key: