Magento 2：如何查找carts/{$cartId}/items接口的完整REST API文档？

你看到的carts/{$cartId}/items接口是已登录用户购物车的商品添加接口，对应完整REST路由为V1/carts/{cartId}/items（代码里省略的V1/前缀应该是客户端封装时统一添加的）。官方在线文档确实可能未完整收录这类接口，你可以通过以下几种方式获取完整文档：

• 本地Magento实例的Swagger文档：在你部署的Magento环境中，直接访问/swagger或/swagger_ui路径，这里会实时生成当前实例所有已启用模块的完整API列表，包含该接口的请求参数、请求体结构、响应示例以及权限要求，比在线文档更全面。
• 查看Magento源码的接口定义：找到Magento_Cart模块下的etc/webapi.xml文件，里面会明确该接口的路由映射、权限控制规则，以及对应的服务接口类；再查看服务类（如Magento\Quote\Api\CartItemRepositoryInterface的save方法）的代码，就能了解接口的具体逻辑和参数细节。
• 使用Magento CLI命令导出API定义：执行bin/magento dev:rest:swagger:generate命令，可生成指定模块或全量的Swagger JSON文件，之后你可以用Swagger UI工具本地加载该文件查看完整的API文档。

内容的提问来源于stack exchange，提问作者Black