Restful api 的资源内容应不应该带上 ID

答案:2 悬赏:80 手机版

解决时间 2021-02-14 09:46

提问者网友：回忆在搜索
2021-02-13 20:15

最佳答案

五星知识达人网友：山君与见山
2021-02-13 20:33

路径，API的具体地址。在REST中，每个地址都代表一个具体的资源（Resource）。所以就有了以下的约定：
路径仅表示资源的路径（位置），以及一些特殊的actions操作。
以复数（名词）进行命名资源，不管返回单个或者多个资源。
使用小写字母、数字以及下划线（“_”）。（下划线是为了区分多个单词，如token_access）。
资源的路径从父到子依次如：/{resource}/{resource_id}/{sub_resource}/{sub_resource_id}/{sub_resource_property}。
使用?来进行资源的过滤、搜索以及分页等。
使用版本号，且版本号在资源路径之前。
优先使用内容协商来区分表述格式，而不是使用后缀来区分表述格式。
应该放在一个专用的域名下，如：http：//api.webfuse.cn。
建议使用SSL。

全部回答

1楼网友：不如潦草
2021-02-13 20:58

一、协议 api与用户的通信协议，总是使用https协议。二、域名应该尽量将api部署在专用域名之下。如果确定api很简单，不会有进一步扩展，可以考虑放在主域名下。三、版本（versioning）应该将api的版本号放入url。另一种做法是，将版本号放在http头信息中，但不如放入url方便和直观。github采用这种做法。四、路径（endpoint）路径又称"终点"（endpoint），表示api的具体网址。在restful架构中，每个网址代表一种资源（resource），所以网址中不能有动词，只能有名词，而且所用的名词往往与数据库的表格名对应。一般来说，数据库中的表都是同种记录的"集合"（collection），所以api中的名词也应该使用复数。

我要举报

如以上回答内容为低俗、色情、不良、暴力、侵权、涉及违法等信息，可以点下面链接进行举报！

点此我要举报以上问答信息