What is an API?
API stands for Application Programming Interface. An API is a defined way for one software system to communicate with another. Instead of knowing how another application works internally, a program can use the interface it exposes.
What is a request?
A request is a message sent to an API asking for information or an action. A request can contain a method, a URL, headers and data. For example, a weather application may request current weather information for a particular city.
What is a response?
The receiving service sends a response. A successful response may contain requested data. An unsuccessful response may contain an error and a status code explaining what happened.
Simple model
Application → API request → Service → API response → Application
Common API methods
- GET — retrieve information
- POST — send or create information
- PUT or PATCH — update information
- DELETE — remove information
Where are APIs used?
APIs are used in payment systems, maps, social platforms, cloud services, authentication, analytics, e-commerce and many other digital products. When a mobile application displays information stored on a remote server, an API may be part of the communication process.
Why does authentication matter?
Some APIs provide public information while others contain private or valuable data. Authentication helps a service identify the caller. Authorization then determines what that caller is allowed to do.
What should students remember?
An API is not simply a database. It is an interface and set of rules for communication. Learning how requests and responses work gives students a useful foundation for web development, mobile development, cloud computing and SaaS.
Worked example: read an API request and response
Suppose a learning app requests public course information from a service. A simplified request might look like this:
GET /api/courses/42 HTTP/1.1
Host: api.example.edu
Accept: application/json
The service might return a success status and a JSON body such as:
{
"id": 42,
"title": "Introduction to Networks",
"level": "beginner"
}
How to read it: the method is GET, the path identifies the requested resource, the Accept header says the client can handle JSON, and the body contains structured data. This is a teaching example, not a real service endpoint.
API design checklist
- Use clear resource names and document required parameters.
- Handle common outcomes such as success, not found, invalid input and missing authentication.
- Never place secret API keys or passwords in public frontend code.
- Request only the data and permissions the application needs.
- Test error cases as well as the successful path.
Practice: explain why a server should reject an update request with invalid input rather than silently saving incomplete data. Predict how a client relying on old JSON field names might break after a change.
Further reading
Quick review
- API means Application Programming Interface.
- A request asks a service for data or an action.
- A response returns data or an error.
- Authentication helps identify a caller.
- Authorization controls permissions.