TR User API V2
Syed Fida Ul Hassan (Unlicensed)
Ranvijay Sahay
Nadja Bengtson (Unlicensed)
Thomas Hellstrøm (Unlicensed)
Limits
Please read the API Usage Notice before implementing API consumption. This api will by default get 25 positions and have a max on 100, to change this or do paging please read the section about common parameters for RESTFul apis.
Introduction
HRMTS provides a set of RESTFul Web Service to retrieve various information through Third Party Systems. The function of this Web Service is restricted to read-only. The User api shows users connected to departments and does not support direct lookup of user id. Details are not shown.
Formats
The Web Service methods return data stored in the System as XML and JSON as the other APIS.
URL Format
All the Web Service methods use a common convention in their URLs. The URLs consist of parts for customer alias, API key and method name. E.g.:
https://recruiter-api.hr-manager.net/restful.svc/v2/{CUSTOMER-ALIAS}/Users/
When calling an API method, simply replace these parts with proper values.
API Key
Calling the above API requires an API Key with the key name "apikey". This should be sent as a request header.
Below is a curl example to fetch candidates for a customer using restful service passing API Key and value in the request header.
curl https://recruiter-api.hr-manager.net/restful.svc/v2/{CUSTOMER-ALIAS}/candidates/ -H "apikey: {API-KEY-VALUE}" -H "Content-Type: application/json"
Items
The node for items include the list of user data objects.
<User> <Id>100</Id> <ThirdPartyUserId/> <Email>john.doe@hr-manager.cool</Email> <Title/> <FirstName>John</FirstName> <LastName>Doe</LastName> <Details i:nil="true"/> </User>