API 文档

注意事项

最近更新时间:2020-05-28 13:32:54

您可以使用 API 网关将业务设计为 API 开放出来,在设计 API 时,为了方便您后续的使用,建议遵循以下规则设计 API:

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