在 RESTful API URI 中,不需要包括动词。实际上,RESTful API 的设计原则之一就是将 HTTP 动词(例如 GET、POST、PUT、DELETE 等)与资源的 URI 分离开来。
URI 应该只标识资源的位置,而不应该描述要执行的操作。HTTP 动词则表示要在该资源上执行的操作类型。例如,如果客户端想要获取某个资源的信息,它会使用 GET 请求,在 URI 中指定该资源的位置。类似地,如果客户端想要更新资源的信息,它会使用 PUT 或 PATCH 请求,指定要更新的资源的 URI。
因此,在 RESTful API URI 中不需要包括动词。相反,应该使用动词来定义 HTTP 方法,以便在资源上执行所需的操作。这有助于提高 API 的可读性、可维护性和可扩展性。
需要注意的是,在设计 RESTful API URI 时,应该遵循一些基本原则,例如使用名词表示资源、使用复数形式表示集合资源等等。这些原则可以帮助我们设计出清晰、易懂、易用的 RESTful API 接口。