Getting Started

The Talenteca API provide services for publishing job ads and recieve candidates using JSON over HTTPS connections.

An app can make calls to Talenteca following these steps:

  1. First, get your security credentials from Talenteca

  2. With your security credentials you can get access tokens from Talenteca users.

  3. Using a valid access token you may now make calls to Talenteca.

1. Security Credentials

The security credentials includes an app ID and an app secret with a list of scopes of services you are entitled to access.

Please contact Talenteca via support@talenteca.com for more information and for getting your security credentials.

Once you get your security credentials, keep the app secret encrypted, hidden and safely stored, it's your responsability to keep this information secure and safe, if not, Talenteca will revoke your access.

2. Access Tokens

An access token is just a long random string with your app ID and the Talenteca user ID inside for granting permissions to call the Talenteca API.

For getting an access token you need to redirect your user to Talenteca using your app ID.

This redirect contains what is called a challenge code, which is simply another long random string used to identify your permission request.

It's important to notice that a challenge code it's only valid for a couple of minutes. This is for reducing exposure of sensible data between your system, our users and Talenteca.

Once the user grants your app with the right permissions, you may exchange the challenge code while is valid and active, for a long lasting valid access token.

3. Make Talenteca API calls

With a valid access token, now you can make calls to Talenteca.

A call to Talenteca API has the following characteristics:

  • The Talenteca API calls use JSON endpoints over HTTPS.

  • For making the calls easier, only the HTTP POST method is required.

  • The only response codes we use are OK (200), Bad Request (400) and Server Error (500).

Services

The Talenteca API services are published at https://www.talenteca.com/api for helping on handling data for recruiters, job ads, candidates and applications.

1. Recruiters

Recruiters are the Talenteca users in charge of publishing, editing and managing job ads including the candidates that apply to their job ads.

2. Job ads

Job Ads are open positions offered by a company requiring new employees.

3. Candidates

Candidates are potential new employees than can apply to a job ad.

4. Applications

Applications are candidates intentions to enroll in new positions published on job ads.

Next steps

Now you can continue with the guide to learn more about security and the available services to call.