Talentguide

Linking to talentguide

This document describes how to link to talentguide. Head to the playgroud where you can build and test your links or take a look at these code examples for building links to talentguide:

Link style

The link to talentguide should be styled as follows and should be opened in a new tab or window:

Base URL

The base URL for linking to talentguide is: https://development.api.talentguide.com/public/v1/link

The link should be opened using the HTTP GET method.

Authentication & Security

Links are secured using a HMAC hash. The hash is calculated using the following formula: MD5(talentspace;email;timestamp;secret)

The secret is a shared secret specific for the talentspace. The timestamp is an ISO_8601 timestamp used to validate the request. see https://en.wikipedia.org/wiki/ISO_8601. The user is the email of the user that will be used for sign-in in or sign-up. The talentspace is the unique identifier of your talentspace.

Our system will validate the request by first validating that the timestamp is not older than 5 minutes. Next it will be calculating the HMAC hash again and comparing it to the provided hash. Any tampering with the request will result in a different hash. If the hashes do not match, the request is invalid and the user will be redirected to an error page. If the hashes match, the request is valid and the user will be accepted. This starts a workflow where the user will be signed in or sign's up. The profile information will be used to enrich the user profile. The job will be added to the user's job list.

For more info about HMAC hashes, see https://en.wikipedia.org/wiki/HMAC.

For more info about MD5 hashes, see https://en.wikipedia.org/wiki/MD5.

Request Parameters

All parameters should be percent encoded (url encoded). For more info about percent encoding, see https://en.wikipedia.org/wiki/Percent-encoding.

Name	Mandatory	Description
talentspace	x	the unique identifier of your talentspace.
email	x	the email of the user that will be used for sign-in in or sign-up.
profile_url		A publicly accessible URL holding information to enrich the user profile (e.g., resume, diploma, etc.).
job_url		A publicly accessible URL holding job or vacancy information.
timestamp	x	ISO_8601 timestamp used to validate the request. see https://en.wikipedia.org/wiki/ISO_8601.
hmac	x	MD5 hash of "talentspace;email;timestamp;secret". The secret is a shared secret specific for the talentspace. see https://en.wikipedia.org/wiki/HMAC.
language		The language to use for the session in ISO 639 format. see https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes.
utm_id		Used to identify which ads campaign this referral references. Use utm_id to identify a specific ads campaign. The value will be provided.
utm_source	x	Use utm_source to identify a search engine, newsletter name, or other source. The value will be provided.
utm_medium	x	Use utm_medium to identify a medium such as email or cost-per-click. The value will be provided.
utm_campaign		Used for keyword analysis. Use utm_campaign to identify a specific product promotion or strategic campaign. The value will be provided.
utm_term		Used for paid search. Use utm_term to note the keywords for this ad. The value will be provided.
utm_content		Used for A/B testing and content-targeted ads. Use utm_content to differentiate ads or links that point to the same URL. The value will be provided.