Retrieve job details for display
This is an overview of how to integrate with SnapHire to retrieve jobs to display on a careers site. Detailed developer docs are available at http://devdocs.talentappstore.com/doc/home.htm.
Define your app in Talent App Store
-
Sign up to https://developer.talentappstore.com
- Create an app
- Take note of the HMAC secret for your app, you’ll need this for making/receiving API calls, as it acts like an API key
- Browse to the APIs tab and define your app as per below
Producing
Method
API
SoT (Source of Truth)
GET
/appStatus
No
Consuming
Method
API
SoT (Source of Truth)
GET
/jobs/open/externally
Yes
GET
/categories/withValues
Yes
-
Browse to the Tazzy tab, and enter your backend server URL. For testing purposes you might want to use ngrok (https://ngrok.com/) to expose your locally running code
TAS APIs your app must expose
Check that the value of the `tazzy-secret` header on all API calls matches the HMAC secret for your app.
App install
Core / Lifecycle API
This API is called when your app is installed by a tenant in the Talent App Store.
App uninstall
Core / Lifecycle API
This API is called when your app is uninstalled by a tenant in the Talent App Store.
App Status
Optional
This API is called when someone who has your app installed in their tenant, views your app in the Talent App Store marketplace. It is used to indicate if the app is ready to use for them, or if any further configuration is required.
APIs your app will call
These API calls can not be made from the front end, as that would result in exposing the HMAC secret for the app.
Set the tazzy-secret header with your app's HMAC secret value.
Retrieve jobs from SnapHire
This will return 100 results at a time, use the jobId to iterate through the list to retrieve the full set.
Recommend caching these results for performance reasons and perhaps calling these APIs every X minutes to retrieve updates.
Retrieve category information
This will return all the categories and their values within the SnapHire site.
Commonly used categories
You will probably be interested in the following categories.
Category name
Description
LOCATION
WORKTYPE
EXPERTISE
