网络与接口

端点

/ END-poynt /

端点(endpoint)是 API 对外开放的一个具体地址,对应一个具体的动作。如果说 API 是整张菜单,那端点就是上面的某一行:一个像 /users 这样的 URL,你可以「访问」它来完成某件事。往那个地址发一个请求,API 就把那一件事做好、然后回复你。

每个端点通常由一个路径加上一个「动词」组成,动词说明你想干什么:GET /users 意思是「把用户列表给我」,POST /users 意思是「新建一个用户」,GET /users/42 意思是「让我看看 42 号用户」。同一个地址,换个动词,就是不同的动作——就像对着同一个柜台,要么让它给你看一份记录,要么让它帮你新建一份。

所以 API 说到底就是一组整整齐齐的端点,每一个都是通往某项具体能力的一扇有名字的小门。学一个 API,大半就是在学它的端点清单:有哪些门,每扇门各自做什么。

GET  /users        → list everyone
POST /users        → create a new user
GET  /users/42     → fetch user #42

同一个 API 上的三个端点:路径相近,动词不同,做的事也不同。

动词(GET、POST……)占了一半含义——GET /users 和 POST /users 实际上是两个不同的端点。

又称
routeurlapi routeresource path