In this section you will find information on how to start using Talentsoft Talent Management and HUB apis.

First you will need to create api key, an then use the Api key to retrieve a token.

How do I create a career API key?

To create an API key, you need to be autonomous.

You must have the following rights:

• View a user's API keys (module: Administration > sub-module: Manage user accounts).
• Edit a user's API keys (Administration > sub-module: Manage user accounts). Then, in Administration > Employees, select the employee to whom the API key is to be assigned. Click on "Add API key" in the "Account management" Quicklook.

A new key is generated:

You'll need to make a note of the secret key, as it will no longer be accessible or modifiable in the application once created.

Click on the green tick to validate the creation of the API key.

Returning to the "Account management" quicklook, the "API keys" link lets you view all the keys associated with the selected user, and delete them if they are no longer required.

TEST or PROD environments

Executing an API request requires the creation of an API key in the TEST or PROD environment. Note that it is not possible to use the same API Key to execute a request in TEST and PROD.

API key created in TEST can only be used in TEST environment. API key created in PROD can only be used in a PROD environment.

How to recover an authentication token via api/token?

Once these keys have been generated, you can then make a request using a tool such as Postman to retrieve an authentication token to use in your API requests.

In Postman :

• add the URL of your environment in the Request URL field, followed by api/token (for example: https://xxx.talent-soft.com/api/token ).

• select the POST method.

In the parameters, add :

• grant_type: client_credentials

• client_id : the public key generated using the procedure described in the paragraph "How do I create a new API key?"

• client_secret : the private key generated using proceduredescribed in the paragraph "How do I create a new API key?"

Click on Send to send the request. The token can be found in the "access_token" field of the response:

The token is valid for approximately 20 minutes. This token must be used to authenticate subsequent API calls.