Developer guide to get employee data from Darwinbox

Introduction

This article is a part of a series of articles covering the Darwinbox API in depth, and covers the specific use case of using the Darwinbox API to Get employee data from Darwinbox API.

You can find all the other use cases we have covered for the Darwinbox API in this guide along with a comprehensive deep dive on its various aspects like authentication, rate limits etc

Get Employee Data from Darwinbox API

Prerequisites

Access to Darwinbox APIs is restricted to privileged users. To get employee data from Darwinbox API:

• Ensure you have the necessary permissions.
• Obtain an API key and a unique dataset key from the Darwinbox team.
• Ensure you have the correct subdomain for your Darwinbox instance.

API Endpoint

To fetch employee data, use the following API endpoint:</p><pre>https://{{subdomain}}.darwinbox.in/masterapi/employee</pre>

Step-by-Step Guide

Fetch Data for a Single or Multiple Employees

import requests

url = "https://{{subdomain}}.darwinbox.in/masterapi/employee"

payload = {
    "api_key": "your_api_key",
    "datasetKey": "your_dataset_key",
    "employee_ids": ["A123", "A124"]
}

headers = {
    "Content-Type": "application/json"
}

response = requests.post(
    url,
    json=payload,
    headers=headers,
    auth=("username", "password")
)

print(response.json())

Fetch Data for All Employees

Set up the request with the required parameters: <code>api_key</code> and <code>datasetKey</code>.

Use the HTTP POST method to send the request.

Include basic authentication with your username and password.

Set the <code>Content-Type</code> header to <code>application/json</code>.

Send the request and handle the response.

import requests

url = "https://{{subdomain}}.darwinbox.in/masterapi/employee"

payload = {
    "api_key": "your_api_key",
    "datasetKey": "your_dataset_key"
}

headers = {
    "Content-Type": "application/json"
}

response = requests.post(
    url,
    json=payload,
    headers=headers,
    auth=("username", "password")
)

print(response.json())

Common Pitfalls

Pitfall 1: Incorrect API key or dataset key will result in authentication errors.

Mitigation: Ensure the subdomain is correctly specified for your Darwinbox instance.

Pitfall 2: Missing <code>Content-Type</code> header may lead to request failures.

Mitigation: Ensure employee IDs are correctly formatted as an array when fetching specific employees.

Pitfall 3: Network issues can cause request timeouts

Mitigation: Ensure stable internet connectivity.

Frequently Asked Questions

1. What should I do if I receive an authentication error?

Verify your API key, dataset key, and credentials.

2. Can I fetch data for multiple employees in one request?

Yes, by providing an array of employee IDs.

3. Is there a limit to the number of employees I can fetch in one request?

Check with Darwinbox support for any limitations.

4. How often are the API specifications updated?

Darwinbox updates API specifications monthly.

Knit for Darwinbox API Integration

For quick and seamless access to Darwinbox API, Knit API offers a convenient solution. By integrating with Knit just once, you can streamline the entire process. Knit takes care of all the authentication, authorization, and ongoing integration maintenance, this approach not only saves time but also ensures a smooth and reliable connection to your Darwinbox API.

---

Ready to build this integration?
Explore Knit’s Darwinbox integration or read more about our Unified HRIS API.