Overview: The Project API

Versions

There are currently two versions of the Project API available. This documentation covers the latest version, Version 2.

Security

This API is intended to be consumed by applications, therefore a high standard of security is implemented.

  • You may create one or more applications in your account prior to using the API.
  • Without doing creating an application, 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 permission to 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 person.png button in the top right, and select API Access:

mceclip0.png

Next, click Project API (v2):

mceclip1.png

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 as useful in the future as 'Integration Test 2021', should you need to revoke the keys.

Once you've named your application, click +Add Application:

mceclip2.png

Your application will be added to the list of available applications, and the Public Key and Private Key shown alongside the application name.

publicprivatekey.png

 

Was this article helpful?
0 out of 0 found this helpful

Articles in this section

See more
Request support
Access support that’s tailored to you by getting in touch with our Support Team.
Send us feedback
Do you have a new feature request, or want to tell us about something that works well (or not so well) for you? Get in touch!