www.talend.com Open in urlscan Pro
2a05:d014:58f:6202::1f4  Public Scan

Submitted URL: https://restlet.org/
Effective URL: https://www.talend.com/resources/what-is-an-api/
Submission: On April 14 via api from US — Scanned from DE

Form analysis 0 forms found in the DOM

Text Content

Talend logo
Main Navigation
 * Products
   * Talend Data FabricThe unified platform for reliable, accessible data
   * Data integration
   * Application and API integration
   * Data integrity and governance
   * Powered by Talend Trust Score
   * StitchFully-managed data pipeline for analytics
 * Solutions
   * Industries
     * Financial services
     * Healthcare
     * Government
     * Retail
     * Telecommunications
   * Departments
     * Operations
     * Sales
     * Marketing
     * Product intelligence
   * Initiatives
     * Cloud data lakes
     * Customer 360
     * Risk and compliance
     * Cloud data warehouse
     * Data privacy
   * See all »
 * Pricing
 * Partners
   * Technology
     * Snowflake
     * AWS
     * Azure
     * Databricks
     * Google
     * Cloudera
   * Channel
     * Partners
     * Find a Partner
     * Partner Portal login
     * Partner training
 * Why Talend
   * Why Talend
   * About us
   * Customers
   * Support and services
   * Community
   * Help center
 * Resources
   * Resource center
   * Knowledge center
   * White papers
   * Webinars
   * Blog
   * Events
 * Free Trial
 * Log in
 * International Sites
   * English (UK)
   * Français
   * Deutsch
   * Italiano
   * 日本語

Skip to main content


WHAT IS AN API (APPLICATION PROGRAMMING INTERFACE)? DEFINITION AND EXAMPLES


 * Knowledge center»
 * Application and API integration»
 * What is an API (application programming …

RELATED ARTICLES

 * What is application integration?
 * What is API management? Guide to API management tools and platforms

A lot of people who work in technology have an intuitive understanding of what
an API (application programming interface) is — but if you asked them to define
it, they might have trouble putting an explanation into words. In simple terms,
an API is both a piece of software running on a networked server and a component
of programming code.

APIs are standards for application data interchange, just as protocols are
standards for network data interchange. Without them, software developers would
have a much harder time writing code to get information from platforms or apps
they want to access.


API DEFINITION

When running on a server, an API is a set of coded routines that receives
requests from and sends responses to other programs. API designers implement
that code through standardized programming statements that expose functions that
make sense for accessing the platform in question.

For example, suppose you wanted to incorporate a map to your business on your
website or display a list of your latest tweets. You can’t directly access
Google Maps or Twitter — the code that runs those sites sits on Google and
Twitter servers. But those platforms provide APIs that let authorized users
retrieve data from their sites.

The Google Maps API and Twitter API may be among the most widely used API
examples, but most software-as-a-service (SaaS) providers offer APIs that let
developers write code that posts data to and retrieves data from the provider’s
site as well.

Developers can use multiple different programming languages to create web-based
APIs, including Java, JavaScript, Perl, Python, and Ruby. Each call that’s a
part of these APIs has a defined syntax, and each vendor that provides an API
documents its syntax, usually on their site or sometimes on sites like GitHub or
ProgrammableWeb.

Most types of APIs have several methods, or operations, that allow developers to
create, retrieve, update, and delete data. The verbs used to implement these
methods are, respectively, POST, GET, PUT, and DELETE. Each method generally
takes a payload in the form of a file in a defined format (usually JSON or XML)
that contains the data to be operated on, and uses a URI (Uniform Resource
Identifier) that acts as an address where the API can interact with the calling
program.

How does that look in practice? Let’s look at a Talend API as an example. The
Stitch Import API lets developers send data from an arbitrary source to the
Stitch data pipeline. You can push a single record through the Stitch data
pipeline with a POST API call:

<pre> curl -X "POST" " https://api.stitchdata.com/v2/import/batch" \
     -H 'Authorization: Bearer [ACCESS_TOKEN]' \
     -H 'Content-Type: application/json' \
     -d $
'{
    "table_name": "customers",
    "schema": {
      "properties": {
        "id": {
          "type": "integer"
        },
        "name": {
          "type": "string"
        },
        "age": {
          "type": "integer"
        },
        "has_magic": {
          "type": "boolean"
        },
        "modified_at":{
            "type":"string",
            "format":"date-time"
         }
      }
    },
    "messages": [
      {
        "action": "upsert",
        "sequence": 1565880017,
        "data": {
          "id": 1,
          "name": "Finn",
          "age": 15,
          "has_magic": false,
          "modified_at":"2020-12-13T21:25:03+0000"
        }
      }
    ],
    "key_names": [
      "id"
    ]
  }'
</pre>

APIs are useful because they make software developers more productive. Without
them, all developers would have to write and then maintain their own code to
access remote resources. Having a standard way to read from and write to those
resources makes the platform that provides the API more accessible and more
attractive to developers, therefore increasing the likelihood that third parties
will use and exchange data with their platform.

Learn how to take an API-first approach to development with our Field Guide to
Web APIs

Get the ebook



HISTORY OF APIS

APIs have been around longer than the World Wide Web — for several decades, in
fact. They became more popular with the rise of network computing, when
server-based application vendors and operating systems needed standard ways to
allow clients to access server resources.

As the Web became ubiquitous, APIs moved into web development. Salesforce
introduced the first web APIs when it launched in 2000.


API DESIGN

Many of these early APIs relied on SOAP — Simple Object Access Protocol.
“Simple” was a misnomer. SOAP relies on XML documents and remote procedure calls
(RPC). Developers had to concern themselves with things like transport bindings,
operation names, and endpoint URIs. No one set standards for API design, so SOAP
APIs were hard to maintain.

An alternative known as CORBA (Common Object Request Broker Architecture),
defined by the Object Management Group (OMG), was even more complex.


REST API

Recognizing the need for simplicity, computer scientist Roy Fielding proposed
representational state transfer (REST) in his Ph.D. thesis as “an abstraction of
the architectural elements within a distributed hypermedia system” — namely the
World Wide Web. It provides roles for a user agent (commonly a web browser), an
origin server that provides access to web services, and intermediary components
that forward requests and responses. RESTful web services allow requesting
systems to access and manipulate representations of web resources by using a
uniform, predefined set of stateless operations. Stateless just means that the
web services don’t retain session information from one request to another.

eBay launched the first REST API in 2002, and quickly proved the wisdom of
allowing developers who worked outside the company to add value to eBay’s
platform. Since that time, software development teams have written APIs not just
for web-based services, but for social media, mobile applications, and hardware
devices (the Internet of Things, or IoT), among other platforms. Today, almost
all vendors' APIs are REST-based APIs.

Most APIs are public APIs (also called open APIs). After all, if programmers
outside your organization can’t use your API, how much value does it have? But
private APIs can be useful in certain circumstances, such as internal APIs that
can only be accessed and used by an organization’s developers for internal use
cases. Partner APIs fall somewhere in between, accessible only to a company’s
business partners.


API INTEGRATION

APIs are also a key tool for application integration. Application integration is
a means of enabling applications and systems from different vendors to involve
each other in their workflows, so that, for example, you can enter data in one
application and have it automatically available in other platforms.

An API integration serves as the connection between two applications, letting
them exchange data. APIs allow developers to sync data between multiple
platforms and can facilitate communication among the various microservices in
web applications. API integration is what does the work when, for example, you
enter a new contact in Salesforce and it auto-populates to Marketo as well.

A key advantage of API integration is that it automates data sharing in a secure
process, therefore helping maintain data integrity between platforms.


API MANAGEMENT

To create APIs, businesses turn to API management software. API management tools
foster the creation and publication of APIs, enforce usage policies, control
access, collect and analyze usage statistics, and report on performance. Both
commercial and open source API management tools are available. You can read more
about them.


TALEND API SERVICES

Many organizations see the value of offering APIs to let outside developers
interact with their platforms, but designing and documenting APIs can be a major
project that takes months of developer time and costs tens of thousands of
dollars.

Rather than start from scratch, businesses can use Talend API Services to do the
heavy lifting. It lets developers collaborate to create and test new APIs with
visual design tools and an intuitive user interface. We’d be happy to give you a
demo and show you what Talend API Services can do for you.


READY TO GET STARTED WITH TALEND?



Contact sales

 * 
 * 
 * 
 * 

 * Products
 * Talend Data Fabric
 * Data integration
 * Data integrity and data governance
 * Application and API integration
 * Powered by Talend Trust Score™
 * Stitch ETL
 * Pricing

 * Get started
 * Free trial
 * Request demo
 * Contact sales
 * Why Talend
 * Customers
 * Find a partner
 * Be a partner
 * Community

 * Services and support
 * Technical support
 * Consulting
 * Training
 * Resources
 * Resource center
 * Knowledge center
 * Blog
 * Help center

 * Company
 * About us
 * Leadership
 * News
 * Careers
 * Contact us
 * Legal
 * Privacy center
 * Cookie policy
 * Privacy policy
 * Do not sell or share my personal information

 * Terms of Use
 * Security
 * Site map

© 2005 - 2024 Talend, Inc., All Rights Reserved



We use cookies to improve your experience with our websites and to deliver
content tailored to your interests. For details on cookie usage on our sites or
to change your cookie settings and preferences, click on More Information. For
further information, see ourPrivacy & Cookie Notice.
Accept All
Reject All
More Information


GENERAL INFORMATION ON COOKIES

When you visit any website, it may store or retrieve information on your
browser, mostly in the form of cookies. The information does not usually
directly identify you, but it makes the site work as you expect it to and can
give you a more personalized web experience. Because we respect your right to
privacy, you can choose not to allow some types of cookies by clicking on the
different category headings to find out more and change your settings. However,
blocking some types of cookies may impact your experience of the site and the
services we are able to offer.
Privacy & Cookie Notice
Allow All


MANAGE CONSENT PREFERENCES

STRICTLY NECESSARY COOKIES

Always Active

These cookies are necessary for the website to function and cannot be switched
off in our systems. They are usually only set in response to actions made by you
which amount to a request for services, such as setting your privacy
preferences, logging in or filling in forms.    You can set your browser to
block or alert you about these cookies, but some parts of the site will not then
work.

Cookies Details‎

FUNCTIONAL COOKIES

Functional Cookies

These cookies enable the website to provide enhanced functionality and
personalization. They may be set by us or by third party providers whose
services we have added to our pages. If you do not allow these cookies, then
some or all of these services may not function properly. These cookies do not
typically store personal information enabling us to identify you, but are based
on uniquely identifying your browser and internet device.

Cookies Details‎

PERFORMANCE COOKIES

Performance Cookies

These cookies allow us to count visits and traffic sources so we can measure and
improve the performance of our site and make it easier to navigate. For example,
they help us to know which pages are the most and least popular and see how
visitors move around the site. When analyzing this data it is typically done on
an aggregated (anonymous) basis.

Cookies Details‎

ADVERTISING COOKIES

Advertising Cookies

These cookies may be set through our site by our advertising partners to build a
profile of your interests and show you relevant advertisements on other sites.
They do not typically store personal information enabling us to identify you,
but are based on uniquely identifying your browser and internet device. If you
do not allow these cookies, you will experience less relevant advertising.

Cookies Details‎
Back Button


COOKIE LIST



Search Icon
Filter Icon

Clear
checkbox label label
Apply Cancel
Consent Leg.Interest
checkbox label label
checkbox label label
checkbox label label

Confirm My Choices