DEV Community

Truto
Truto

Posted on • Originally published at truto.one on

What is API in simpler terms?

What is API in simpler terms?

An API simply enables everyday apps you use to talk to each other. Google Analytics to talk to Slack. Salesforce to Gmail. PayPal to QuickBooks.

Before we dive deeper here's a response from chatGPT that'll set the context. We asked it to explain API to a 5-year-old:

Okay, let's imagine you have a toy chest with different toys in it. Each toy can do different things, like a toy car that can drive, a toy robot that can talk, and a toy boat that can float. But all these toys are closed boxes and you can't really play with them. But what if there was a magic key that can open the boxes? That magic key is called an API. When you use the key, it allows the toys to talk to each other and play together. It helps different toys to work together and makes playing with them more fun.

Let's see how this translates to your everyday work as a marketer, salesperson or HR executive -

Marketer

You are probably using an analytics tool such as Google Analytics. Now when there's a significant increase in traffic (>50%), you want to get an alert on your email. An API with an endpoint (fancy nomenclature for name) for traffic from Google Analytics will help make this happen. Your dev team will simply write a few lines of code that do the job of

  • monitoring the endpoint on Google Analytics for its value
  • set a threshold for the value (50%)
  • once the value crosses the threshold
  • send an alert to xyz@xyx.com

Salesperson

You are using a CRM such as Salesforce or HubSpot. When there's a new lead, you want to get an alert on Slack. The lead data is within Salesforce. Salesforce now needs to talk to Slack. Your dev team will simply write code that does the following:

  • monitoring the 'lead' endpoint on Salesforce every few hours
  • find when there's a new lead
  • if there's a new lead, send an alert to 'Slack user'

HR Executive

You are using an HRIS portal such as Workday or BambooHR and an ATS such as Lever or Greenhouse. When you mark a candidate as 'Hired' on Lever, you want that candidate to be created in BambooHR to being the onboarding process. Your dev team will set this up with a few lines of code:

  • monitor the 'candidate status' endpoint on Lever every few hours
  • when a candidate is marked as 'hired' >
  • fetch the following details - candidate name, candidate email, candidate phone, the candidate hired date
  • create a candidate on BambooHR with the fetched details

We hope this helped you understand what an API is in simple terms. To get the message across, we may have over-simplified how it works. It's important to note that the dev teams will spend quite some time trying to understand the API documentation of these apps and writing the code to make these integrations happen.

If you want to make it easier for your dev team, you can ask them to use tools like Truto.one, which will help them quickly set up these integrations for you.

Build +200 native integrations

Using Truto's Unified API for CRM, Unified API for ATS, Unified API for HRIS, Unified API for Accounting, and 26 other categories
Get started free

Top comments (0)