Talent Developer Resources: Concepts
These concepts help you understand key terms and ideas when developing an integration with the Deltek Talent Management API
Deltek Talent uses the following communication types:
A hook is a web-service request from the Deltek Talent system to an external system, that the Deltek Talent system has standardized in advance. Deltek Talent will consume a web service in an external system, but in this case, it is the consumer that has established the standard format and data.
Hook Requests are usually triggered by a human user taking an action in the Deltek Talent TS. The hook is designed to allow an immediate action to be taken and sometimes allow immediate feedback to be presented to that user.
When Deltek Talent registers your integration with our API registration system, we will need you to provide a single URL where any Hook Requests will be sent. Please note that all API communication is required happen via HTTP over SSL. Unsecure connections are not allowed and will not be supported. You can also give us a user name and password to set up per client. This can allow your system to rely on that user name and password instead of our authentication token to identify which client a particular Hook Request is referring to. Please note that this will not change the fact that we will require and rely on the authentication token correctly identifying the client when you make Direct Request.
Direct Requests allow your integration to retrieve or update data to or from the Deltek Talent ATS. You can make a direct request by posting properly formatted XML to our gateway URL.
The Deltek Talent SOA/API version 2.0 supports five types of integrations with the Deltek Talent Enterprise platform:
Through a background check integration a background check provider can integrate with the Deltek Talent ATS. Hooks are available in the ATS interface to both initiate and cancel background checks through the SOA/API. Through direct requests, vendors can request more information about a subject and update the status of a particular background check request without user interaction on the client.
Assessment vendors have similar functionality when integrating with the Deltek Talent Enterprise platform. Hooks are available to initiate and cancel assessments for candidates in a similar fashion to background checks. Direct request operations are also available to update the status of an assessment as well as request more information from the recruiter.
Human Resources Information Systems (HRIS) integrate with the Enterprise platform exclusively through direct requests. HRIS vendors can observe and manipulate organizational levels, jobs, locations, and users to integrate a client's existing HRIS solution with their
The Deltek Talent API has built in support for Single Sign On, allowing a software system to directly log in a user to the Deltek Talent system without presenting them a Deltek Talent login. The Deltek Talent API also has built in support for delegated authentication which allows our system to collect a user name and password through our login screen, but check those credentials against an external system instead of our own database.
Another common use of the Deltek Talent API is the ability to list requisitions from the Deltek Talent ATS in an external system such as on a corporate site. The Deltek Talent API can allow an external system to retrieve information about requisitions so that proper information and links can be displayed in external systems.
One of the key features of the Deltek Talent API is the search capability. This is a collection of similar API calls that allows information to be retrieved using a common XML format. Searches are a special classification of a direct request, and they follow the same XML format. This section will cover the common parts of the search functionality. To see exactly what search API calls are available, what the available criteria to use for each call are, and to see exactly what data will be returned, please see the Search Reference.
To learn more about each of these concepts, click here.