APIs

APIs
API stands for Application Programming Interface. It is a set of rules, protocols, and tools that allow different
software applications to communicate with each other. APIs define the methods and data formats that
developers can use to interact with a software component or service. They enable various functionalities such
as retrieving data, sending requests, and performing specific operations within an application or between
different applications. APIs are commonly used in web development, allowing different systems to integrate
and interact seamlessly.

Types of APIs
There are several types of APIs, each serving different purposes and catering to various needs. Some of the
common types include:
1. Web APIs (HTTP/RESTful APIs): These are APIs that are accessed via HTTP protocols over
the web. They typically follow the principles of Representational State Transfer (REST) architecture
and use standard HTTP methods like GET, POST, PUT, DELETE for communication.
2. SOAP APIs: SOAP (Simple Object Access Protocol) APIs use XML-based messaging protocol for
exchanging structured information. They are more rigid and have a more complex syntax compared to
RESTful APIs.
3. RPC APIs: RPC (Remote Procedure Call) APIs allow programs to call procedures or functions on
remote computers as if they were local. This type of API abstracts the network communication and
allows for distributed computing.
4. GraphQL APIs: GraphQL is a query language for APIs that enables clients to request only the data
they need, in a flexible and efficient manner. It provides a more tailored approach compared to RESTful
APIs.
5. Library-based APIs: These APIs are provided as libraries or software development kits (SDKs) that
developers can directly integrate into their applications to access specific functionalities or services.
6. Hardware APIs: Hardware APIs provide access to hardware components such as cameras, sensors,
and peripherals, allowing software applications to interact with them.
7. Third-party APIs: These are APIs provided by third-party service providers, allowing developers to
integrate external services such as payment gateways, social media platforms, mapping services, etc.,
into their applications.

REST API
REST API, which stands for Representational State Transfer Application Programming Interface, is a type
of web service that allows different software applications to communicate with each other over the internet.
REST is an architectural style for designing networked applications, particularly web services, where resources
(such as data objects or files) are identified by unique URLs.

1
REST APIs are widely used in modern web development for building scalable and interoperable systems.
They are often preferred for their simplicity, flexibility, and compatibility with various programming languages
and frameworks.
Key characteristics of a REST API include:
1. Statelessness: Each request from a client to the server must contain all the information necessary to
understand the request, and the server should not store any client session data between requests. This
makes the API easier to scale and more reliable.
2. Client-Server Architecture: The client and server are separate entities that communicate over
a stateless protocol, such as HTTP. This separation of concerns improves scalability by allowing
components to evolve independently.
3. Uniform Interface: A uniform interface between components simplifies and decouples the architecture,
which promotes the independence of the client and server.
4. Resource-Based: Resources, such as data objects or files, are uniquely identified by URIs (Uniform
Resource Identifiers). Clients interact with resources through a standard set of methods, such as GET,
POST, PUT, and DELETE.
5. Representation: Resources can have multiple representations, such as JSON, XML, or HTML,
allowing clients to request the representation that best suits their needs.
And there are other characteristics as well.

Examples:
There are countless examples of REST APIs in use across various industries and applications. Here are a few
examples:
1. Twitter API: Twitter provides a RESTful API that allows developers to access and interact with
Twitter data, such as tweets, user profiles, and trends. Developers can use this API to build applications
that integrate with Twitter’s platform.
2. GitHub API: GitHub offers a REST API that enables developers to access and manage GitHub
repositories, issues, pull requests, and more. This API allows developers to automate tasks, integrate
with other tools, and build custom workflows around their GitHub projects.
3. Google Maps API: Google Maps provides a RESTful API that allows developers to embed maps,
geocode addresses, calculate directions, and perform various other geographic-related tasks. This API
is commonly used in web and mobile applications to add mapping functionality.
4. OpenWeatherMap API: OpenWeatherMap is a service that provides current weather data, hourly
forecasts, daily forecasts, historical weather, and solar panel energy data for any location on Earth. It
collects and processes weather information from various sources, including global and local weather
models, satellites, radars, and an extensive network of weather stations. The data is available in formats
such as JSON, XML, or HTML12.

HTTP Request
An HTTP (Hypertext Transfer Protocol) request is a message sent from a client (such as a web browser) to a
server, requesting a resource. Here are the key components of an HTTP request:
1. Request Line: This is the first line of the request and contains the following three elements:
• Method: This specifies the action the client wants the server to take. Common methods include
GET, POST, PUT, DELETE, etc.
• URL (Uniform Resource Locator): This is the address of the resource being requested. It
includes the protocol (e.g., http:// or [Link] the domain name, and the path to the resource
on the server.

2
 • HTTP Version: This indicates the version of the HTTP protocol being used, such as HTTP/1.1
or HTTP/2.0.
2. Request Headers: These are additional parameters sent along with the request that provide additional
information to the server. Some common headers include:
• Host: Specifies the domain name of the server being requested.
• User-Agent: Identifies the client software making the request (e.g., browser name and version).
• Content-Type: Specifies the MIME type of the request body for POST requests.
• Accept: Informs the server about the types of content the client can handle.
• Cookies: Contains any cookies associated with the domain being requested.
3. Request Body: This is optional and is used when additional data needs to be sent to the server,
typically with methods like POST or PUT. For example, form data submitted in a POST request would
be included in the request body.
Here’s an example of an HTTP request:
GET /[Link] HTTP/1.1
Host: [Link]
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/97.0
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8
Accept-Encoding: gzip, deflate, br
Connection: keep-alive
The example shows the following:
• Method: GET
• URL: /[Link]
• HTTP Version: HTTP/1.1
• Host: [Link]
• User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko)
Chrome/97.0.4692.71 Safari/537.36
• Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,/ ;q=0.8
• Accept-Encoding: gzip, deflate, br
• Connection: keep-alive
There is no request body in this example as it’s a GET request.

Python requests
Here is an example of using Python requests module to get weather data from OpenWeatherMap.
Here
import requests

# OpenWeatherMap API endpoint

url = '[Link]

# Parameters for the API request

params = {
'q': 'Halifax', # City name
'units': 'metric',
'appid': 'Your API key' # You get the key by subscribing (free)
}

# Send GET request to the API

response = [Link](url, params=params)

# Check if the request was successful (status code 200)

3
if response.status_code == 200:
# Extract and print the weather data
weather_data = [Link]()
print("Weather in Halifax:")
print("Temperature:", weather_data['main']['temp'], "C")
print("Description:", weather_data['weather'][0]['description'])
else:
print("Failed to retrieve weather data. Status code:", response.status_code)