{"id":95847,"date":"2020-08-13T08:53:32","date_gmt":"2020-08-13T15:53:32","guid":{"rendered":"https:\/\/www.backblaze.com\/blog\/?p=95847"},"modified":"2022-07-14T13:24:39","modified_gmt":"2022-07-14T20:24:39","slug":"what-is-an-api","status":"publish","type":"post","link":"https:\/\/www.backblaze.com\/blog\/what-is-an-api\/","title":{"rendered":"What Is an API?"},"content":{"rendered":"

\"What<\/p>\n

Driving on 101 in San Francisco (the highway that runs between San Francisco and San Jose that connects most of what people know as \u201cSilicon Valley\u201d) you see a lot<\/em> of different billboards for tech-related business solutions. One that stood out the first time I saw it was a sign that stated \u201cLearn How to Use Your API Correctly,\u201d and of course my first instinct was to search, \u201cWhat is an API?\u201d to answer the question for myself.<\/p>\n

Things have come a long way since then, but in recent months here at Backblaze, it became clear that understanding exactly how APIs work was very important. And yet, on the verge of our biggest launch in years\u2014our Backblaze S3 Compatible API\u2014I realized that I was far from alone in not fully getting the functionality of APIs.<\/p>\n

If you\u2019re thinking about onboarding some new tools in your home or office that you hope will play well with your existing technology, understanding APIs can be hugely helpful. But when you search \u201cWhat is an API\u201d on Google, you get a lot of technical jargon that might be over your head at first glance.<\/p>\n

To better understand what an API actually<\/em> is, you need to break the definition into parts. We talked to some of our more patient engineers to make sure we understand exactly why<\/em> developers and businesses are so excited about our new suite of Backblaze <\/a>S3 Compatible<\/a> APIs.<\/p>\n

Defining an API (Definition #1)<\/h2>\n

The abbreviation, API, stands for application programming interface. But that doesn\u2019t really answer the question. To get started more constructively, let\u2019s break apart the abbreviation.<\/p>\n

Defining \u201cApplication\u201d<\/h3>\n

Application: An application is the software, website, iOS app, or almost any digital tool that you might want to use.<\/p>\n

Defining \u201cProgramming\u201d<\/h3>\n

Programming: This is what the developer\u2014the person who built the digital tool you want to use\u2014does. They program the software that you will be using, but they also program how that software can interact with other<\/em> software. Without this layer of programming, those of us who aren\u2019t<\/em> developers would have a difficult time getting different applications to work together.<\/p>\n

Defining an \u201cInterface\u201d<\/h3>\n

Interface: An interface is where applications or clearly defined layers of software talk to each other. In the cases we discuss here, we will focus on APIs that talk between applications. Just as a user interface makes it easier for the average person to interact with a website, APIs make it easier for developers to make different applications interact with one another.<\/p>\n

Defining an API (Definition #2)<\/h2>\n

Okay, so now we know what makes up an API on a basic level. But really, what does it do?<\/p>\n

Most simply, APIs are the directions for interaction between different types of software. A common metaphor for how an API works is the process of ordering dinner at a restaurant.<\/p>\n

When you\u2019re sitting at a table in a restaurant, you\u2019re given a menu of choices to order from. The kitchen is part of the \u201csystem\u201d and they will be the ones who prepare your order. But how will the kitchen know what you are picking from the menu? That\u2019s where your waiter comes into play. In this example, the waiter is the communicator (the API) that takes what you chose from the menu and tells the kitchen what needs to be made. The waiter then takes what the kitchen makes for you and brings it back to your table for you to enjoy!<\/p>\n

In this example, the kitchen is one application that makes things, the customer is an application that needs things, the menu is the list of API calls<\/a> you can make, and the waiter is the programming interface that communicates the order of things back and forth between the two.<\/p>\n

\"An<\/p>\n

Types of APIs<\/h2>\n

With a working definition, it\u2019s easier to understand how APIs work in practice. First, it\u2019s important to understand the different types of APIs. Programmers choose from a variety of API types depending on the \u201corder\u201d you make off your \u201cmenu.\u201d Some of these APIs have been created for public use and are widely and openly available to developers, some are for use between specific partners, and some of these APIs are proprietary, built specifically for one platform.<\/p>\n

Public APIs<\/h3>\n

A public API is available to everyone for use (typically without having to pay any royalties to the original developer). There are no specific outlines to the way they are utilized, other than the intention that the API should be easily consumed by the average programmer and be accessible by as many different clients as possible. This helps software developers in that they don’t have to start from scratch every time they write a program\u2014they can simply pull from public APIs.<\/p>\n

For example, Amazon has released some public APIs that allow website developers to easily link to Amazon product information. These APIs communicate up-to-date prices so that individuals maintaining websites no longer need to update a link every time the price of a product they\u2019ve listed changes.<\/p>\n

Partner APIs<\/h3>\n

A partner API is publicly promoted but only shared with business partners who have signed an agreement with the API publisher. A common use case for partner APIs is a software integration between two businesses that have agreed to work together.<\/p>\n

With our Backblaze B2 Cloud Storage product, we have many different integration partners that use partner APIs to better support customers\u2019 unique use cases. A recent integration we have announced is with Flexify.IO. We work together using partner APIs to help customers migrate large amounts of data from one place to another (like from AWS to Backblaze B2 Cloud Storage<\/a>).<\/p>\n

Internal APIs<\/h3>\n

A private API is only for use by developers working within a single organization. The only exposure for this API is within the business and can be adjusted when needed to meet the needs of the company or their customers. When new applications are created they can be pushed out publicly for consumer use but the interface will not be visible to anyone outside of the organization.<\/p>\n

We wish we could share an example, but that would mean the API would be public and no longer \u201cinternal.\u201d A company like Facebook could<\/em> provide a hypothetical example: Facebook owns WhatsApp, Instagram, and numerous other applications that they\u2019ve worked to link together. It\u2019s likely that these different applications speak to one another via internal APIs an open-source programmer might not have access to.<\/p>\n

Defining Backblaze APIs<\/h2>\n

Typically, companies use a variety of public, partner, and internal APIs to provide products and services. This holds true with Backblaze, too. We use a balance of our own internal APIs and we also use some public-facing APIs.<\/p>\n

In our data centers, our Backblaze Vault architecture combines 20 Storage Pods that work collectively to store customers\u2019 files. When a customer uploads a file using the public B2 Native API call, we use our internal APIs to break the data into 20 pieces (we call them \u201dShards\u201d). The 20 Shards consist of 17 data Shards and three parity Shards which we spread out across all 20 Pods. Why? This is our way of keeping your data safe in the cloud. (You can read more about that process here<\/a>.)<\/p>\n

A common public API we have implemented is the Google Single Sign-on (SSO) authentification. SSO systems allow websites to use trusted sites to verify users. As a user, you would want to use SSO to add an extra layer of security onto your account. This public API allows users with Google Accounts to access their Backblaze account with their Google credentials.<\/p>\n

At Backblaze, our engineering team has also created some public APIs with our product, B2 Cloud Storage<\/a>, that are available for anyone interested in using our cloud storage<\/a> product as part of their workflow. If you have ever uploaded data using Backblaze B2, then you have used our B2 Native API. Backblaze supports two different suites of APIs: the B2 Native API and, more recently, the Backblaze S3 Compatible API<\/a>.<\/p>\n

\"An<\/p>\n

What Makes for a Successful API?<\/h3>\n

According to one of our lead engineers, there is a list of criteria that make an API successful or desirable. These criteria include:<\/p>\n