Skip to content
BENIBIX Learn

API Endpoint

Development🔌 APIsAPI Basics

Also known as Endpoint, API Route, Endpoints

One address in an API, plus its method, like GET /users/42.

Think of it like

Think of it like one counter in a post office. Each counter does one kind of job.

Example

Jack's app uses three endpoints. GET /products lists items, POST /orders buys, and GET /orders/1042 tracks a parcel.

Why it matters

Endpoints are what other people's code is written against. A clear, stable list makes an API easy to use.

Definition

An endpoint is one address in an API where you can send a request for one kind of job. It is a method plus a path, like GET /users/42 or POST /orders. Each endpoint takes certain inputs and gives back a certain answer. An API is often described as a list of its endpoints. Changing an endpoint can break every app that uses it.

Example code

http
GET /api/orders/1042 HTTP/1.1
Host: example.com
This endpoint returns one order, number 1042.

Common mistake

Renaming an endpoint that apps already use. Keep the old one working, or add a new version.

Key takeaways

  1. 1
    Method plus path. GET /users/42.
  2. 2
    One kind of job. Set inputs, set answer.
  3. 3
    Keep it stable. Apps depend on it.

Compare