您可以使用 API 网关将业务设计为 API 开放出来,在设计 API 时,为了方便您后续的使用,建议遵循以下规则设计 API:
URI 的末尾不要添加斜杠
/
,资源的 URL 的末尾多一个斜杠会产生歧义,容易被误认为是目录,导致在调用过程中产生误解。使用中划线
-
提高 URI 的可读性,用中划线-
来连接单词这样可以使得 URI 便于理解。禁止在 URL 中使用下划线
_
,因为下划线_
有可能被文本查看器中的下划线特效遮掩,可读性较低。避免使用大写字母,使用大写字母既不美观又容易出错。
不要在 URI 中包含扩展名,而应鼓励 REST API 客户端使用 HTTP 提供的格式选择机制 Accept request header。