Terminology

Term

Explanation

API (Application Programming Interface)

A set of rules that allows two software systems to communicate. It defines how requests should be made and what responses to expect.

Client

The system (like a browser or mobile app) that sends requests to an API.

Server

The system that receives API requests, processes them, and returns responses.

Endpoint

A specific URL or route in an API that represents an action or data source. Example: /users or /products/123.

Request

The message sent by the client to the API, asking for data or action.

Response

The message sent by the API back to the client after processing a request.

HTTP Method (Verb)

The action the client wants to perform. Common ones: GET (read), POST (create), PUT (update), DELETE (remove).

Resource

A unit of data in an API. In REST APIs, resources are typically represented as nouns in the URL, such as users, orders, or products.

Path Parameter

A variable in the URL path used to identify a specific resource. Example: /users/{id}.

Query Parameter

A key-value pair added to the URL to filter or refine the request. Example: /users?active=true.

Header

Key-value pairs sent along with the request or response to provide metadata like content type or authorization.

Body

The main content or data sent with a request (especially in POST, PUT) or returned in a response.

Status Code

A numeric code in the response that tells whether the request succeeded or failed. Example: 200 OK, 404 Not Found.

Authentication

The process of verifying the identity of the client making the API call.

API Consumer

The system or developer that uses the API to perform operations or access data.

API Provider

The system or service that exposes the API and responds to incoming requests.

Statelessness

A principle where each API request is independent and doesn't rely on past requests. Common in REST APIs.

Last updated