Getting started with APIs
I'll be introducing a considerable amount of technical terminology, so before diving in, familiarize yourself with these key API terms.
API call | The process of a client (your computer) initiating an API request to a server |
Request method | Utilizes HTTP methods (GET, POST, PUT, DELETE) to instruct the API on the desired action |
Endpoint | The digital location where an API receives requests for its resources |
API key | A unique combination of letters and numbers providing access to an API |
Step 1: Obtain API key from AanyaHR v2 Portal
Login to appv2.aanyahr.com and navigate to your company's profile. Within your company's profile, you will find your API key.
In case that that you have no API key, click Generate.
Step 2: Obtain Authorization token using Request Access Token API
The next step is to obtain an authorization token using the token endpoint. This token is essential for authenticating and authorizing your requests to the API
Using your preferred testing tool (e.g., Postman), set the endpoint to https://appv2.aanyahr.com:3000/api/connect/token and the request method to POST
Then enter the following body parameters:
Where client_id is your company code and client_secret is the API key from Step 1
Then click Send. You will receive a response similar to the snippet below on a successful API call.
where access_token is the authorization token use to call other APIs and expires_in is the validity duration of the generated access_token in seconds
​
Take note of this token, as you'll need it for subsequent API calls.
Step 3: Obtain Client Key using Request Client Key API
Now that you have the authorization token, the next step you need to do is get the client key from clientKey endpoint
Using the same testing tool used for Step 2, set the endpoint to https://appv2.aanyahr.com:3000/api/connect/clientKey and the request method to POST
On authorization, set type to Bearer Token and enter the token generated from step 2
Then enter the following body parameters:
Where client_id is your company code and client_secret is the API key from Step 1
Then click Send. You will receive a response similar to the snippet below on a successful API call.
Save this response, as it is required for the authentication of subsequent API calls.
Step 4: Make API Calls with Authorization Token and Authentication Keys
Now that you have the necessary authorizations (API authorization token and authentication keys), you can use them in the headers of your requests to the desired API endpoints. Let's consider an example using the GetEmployee01 endpoint.
Using the same testing tool used for Step 2, set the endpoint to https://appv2.aanyahr.com:3000/api/connect/getEmployee01 and the request method to POST
Enter Header params
Where values for User, LoginID, and Series are from response of successful clientKey API call, and Authorization value is from response of successful token API call.
Then enter the following body parameters and click send:
You will receive a response similar to the snippet below on a successful API call.
Congratulations! You have successfully obtained the necessary authorization tokens and made authenticated API calls. Now, you're ready to seamlessly incorporate our APIs into your applications