Understanding APIs: The
Bridge Between Software
Systems
APIs enable two software components to communicate using defined protocols.
They act as bridges, allowing applications to share data and functionality
seamlessly.
by Group 2
What is an API?
Communication Service Contract
Bridge
Acts as a contract between
APIs enable two software applications, defining how they
components to communicate exchange requests and
using defined protocols. responses.
Documentation
Contains information on how developers structure requests and responses.
How APIs Work
Client Request Server Processing Response Delivery
Application sends a request to access data Server receives request and processes it Server sends back requested data or
or functionality. according to API rules. confirmation to the client.
Types of API Architectures
SOAP APIs
Use Simple Object Access Protocol with XML message exchange. Less flexible but
historically common.
REST APIs
Most popular web APIs today. Use HTTP methods like GET, PUT, DELETE to access server
data.
WebSocket APIs
Support two-way communication between client and server. More efficient than REST for
real-time data.
RPC APIs
Remote Procedure Calls execute functions on servers and return outputs to clients.
REST APIs Explained
Stateless HTTP-Based
Servers don't save client data between requests. Uses standard HTTP methods for
communication.
Defined Functions Data Exchange
Uses standard functions like GET, PUT, Clients and servers exchange plain data, not
DELETE for data access. rendered web pages.
API Categories by Scope
Private APIs Public APIs Partner APIs
Internal to an enterprise. Connect systems Open to the public. May be used by anyone Accessible only by authorized external
and data within the business. with possible authorization requirements. developers for business partnerships.
Benefits of REST APIs
Innovation
Enable rapid deployment of new services through API-level changes.
Expansion
Meet client needs across different platforms and devices.
Integration
Connect new applications with existing systems efficiently.
Easy Maintenance
Changes to internal systems don't impact external interfaces.
API Security Essentials
API Keys
Verify the program making the API call.
Authentication Tokens
Authorize users and verify access rights.
API Gateways
Manage authentication, statistics, and rate limiting.
Creating an API
Plan the API
Create specifications and blueprints for your API design.
Build the API
Prototype with boilerplate code, then customize to
specifications.
Test the API
Perform security and functionality testing to prevent bugs.
Document the API
Create comprehensive guides to improve usability.
Market the API
List your API in marketplaces to reach potential users.
AWS API Services
Amazon API Gateway AWS AppSync
Fully managed service for creating, Managed service for GraphQL APIs with
publishing, and securing APIs at scale. real-time data updates.
Security Features Application Integration
Built-in tools for authentication, Comprehensive set of services for
3
authorization, and monitoring. connecting applications.