What is it?
An endpoint is a specific address where an API provides data or functionality.
Simple Definition:
An endpoint is one specific access point inside an API.
Software Knowledge → 03 · HTTP & APIs → Endpoint
A specific address that provides access to an API resource or function.
An endpoint is a specific address where an API provides data or functionality.
Simple Definition:
An endpoint is one specific access point inside an API.
Think of an API as a building.
Each endpoint is a specific service desk inside that building.
│├─ /api/orders├─ /api/customers├─ /api/products└─ /api/paymentsAn endpoint identifies:
Endpoints appear in:
GET is the HTTP method.
/api/orders is the endpoint.
Purpose: Retrieve order data.
Same endpoint.
Different method.
Different action.
The endpoint tells the request where to go.
The method helps describe what action should happen there.
The complete interface containing multiple functions or resources.
One specific access point inside that API.
| ENGLISH TERM | 中文 | SIMPLE ENGLISH | 中文小白理解 |
|---|---|---|---|
| Endpoint | 接口地址 | A specific address that provides an API function. | API 中提供某个具体功能的访问地址。 |
| API | 应用程序接口 | A collection of defined software functions or resources. | 对外提供一组功能或数据访问方式的软件接口。 |
| URL | URL 地址 | The address used to locate a web resource. | 用来定位网页、接口或其他网络资源的地址。 |
| Path | 路径 | The part of a URL that identifies a resource. | URL 中用来标识具体资源的位置部分。 |
| Method | HTTP 方法 | The action requested at an endpoint. | 在某个接口地址上希望执行的操作类型。 |
| Route | 路由 | Backend logic that maps a request path to code. | 后端把请求地址映射到处理代码的规则。 |
| Resource | 资源 | Data or functionality exposed by an API. | API 对外提供访问的数据或功能。 |
| Request | 请求 | A message sent to an endpoint. | 发送到某个接口地址的数据或操作请求。 |
| Response | 响应 | The result returned after the endpoint is processed. | 接口处理完成后返回的数据或结果。 |
| API Documentation | API 文档 | Documentation listing endpoints and how to use them. | 说明有哪些接口、怎么调用以及返回什么的文档。 |
An endpoint is one specific access point inside an API.
Endpoints are usually represented by URLs or URL paths.
The method and endpoint together describe an API operation.