# 宠物商店

## Docs
- [接口文档说明](https://wn50ds108y.apifox.cn/doc-5412598.md): 
- [Changelog](https://wn50ds108y.apifox.cn/doc-6573728.md): 
- Apifox Markdown [巧用“目录树+自定义标题”分离结构](https://wn50ds108y.apifox.cn/doc-6164436.md): 
- Apifox Markdown [“容器+列表”实现左右对照](https://wn50ds108y.apifox.cn/doc-6164528.md): 
- Apifox Markdown [步骤组件](https://wn50ds108y.apifox.cn/doc-6440547.md): 
- Apifox Markdown [图片](https://wn50ds108y.apifox.cn/doc-6247505.md): 
- Apifox Markdown [项目资源的插入](https://wn50ds108y.apifox.cn/doc-6560911.md): 
- Apifox Markdown [链接与锚点跳转](https://wn50ds108y.apifox.cn/doc-6562563.md): 
- Apifox Markdown [表格](https://wn50ds108y.apifox.cn/doc-6564892.md): 
- Apifox Markdown [折叠块](https://wn50ds108y.apifox.cn/doc-6564893.md): 
- Apifox Markdown [告示与高亮块](https://wn50ds108y.apifox.cn/doc-6565120.md): 
- Apifox Markdown [文字 Hover 提示与复制](https://wn50ds108y.apifox.cn/doc-6565337.md): 
- [商城 API](https://wn50ds108y.apifox.cn/folder-42127974.md): 
- 商城 API > 开始使用 [介绍](https://wn50ds108y.apifox.cn/doc-5173712.md): 
- 商城 API > 开始使用 [身份验证](https://wn50ds108y.apifox.cn/doc-5173713.md): 
- 商城 API > 开始使用 [HTTP压缩](https://wn50ds108y.apifox.cn/doc-5173714.md): 
- 商城 API > 开始使用 [发布API密钥](https://wn50ds108y.apifox.cn/doc-5173715.md): 
- 商城 API > 开始使用 [扩展字段](https://wn50ds108y.apifox.cn/doc-5173716.md): 
- 商城 API > 开始使用 [选择字段](https://wn50ds108y.apifox.cn/doc-5173717.md): 
- 商城 API > 开始使用 [查询参数类型](https://wn50ds108y.apifox.cn/doc-5173718.md): 
- 商城 API > 开始使用 [分页](https://wn50ds108y.apifox.cn/doc-5173719.md): 
- 商城 API [地区](https://wn50ds108y.apifox.cn/folder-42127976.md): 
- 线上文档示例 [运行测试场景](https://wn50ds108y.apifox.cn/doc-5880930.md): 

## API Docs
- 示例项目 [查询宠物详情](https://wn50ds108y.apifox.cn/api-205194698.md): 
- 示例项目 [新建宠物信息](https://wn50ds108y.apifox.cn/api-205194699.md): 
- 示例项目 [删除宠物信息](https://wn50ds108y.apifox.cn/api-205194701.md): 
- 示例项目 [根据状态查找宠物列表](https://wn50ds108y.apifox.cn/api-205194702.md): 
- 示例项目 [修改宠物信息](https://wn50ds108y.apifox.cn/api-205194700.md): 
- 商城 API > 地区 [获取地区列表](https://wn50ds108y.apifox.cn/api-217020143.md): 检索地区列表。地区可以通过诸如 `created_at` 之类的字段进行过滤。地区也可以分页。此 API 路由可用于向客户展示所有可供选择的地区。
- 商城 API > 地区 [获取地区](https://wn50ds108y.apifox.cn/api-217020144.md): 检索地区的详细信息。
- 商城 API > 产品 [搜索产品](https://wn50ds108y.apifox.cn/api-217020145.md): 使用安装在 Medusa 后端上的搜索服务对产品运行搜索查询。搜索是通过搜索服务处理的，因此返回数据的格式取决于您使用的搜索服务。
- 商城 API > 产品 [获取产品列表](https://wn50ds108y.apifox.cn/api-217020146.md): 检索产品列表。产品可以通过诸如 `id` 或 `q` 之类的字段进行过滤。产品也可以排序或分页。
- 商城 API > 产品 [获取产品](https://wn50ds108y.apifox.cn/api-217020147.md): 检索产品的详细信息。为了根据客户的情况准确、正确地定价产品，强烈建议通过以下字段
- 商城 API > 客户信息 [请求密码重置](https://wn50ds108y.apifox.cn/api-217020148.md): 创建一个重置密码令牌，以便在后续的重置密码 API 路由中使用。这将发出 `customer.password_reset` 事件。如果在 Medusa 后端安装了通知提供程序，并且配置为处理此事件，则可能会向客户发送包含重置说明的通知，例如电子邮件。
- 商城 API > 客户信息 [获取保存的支付方式](https://wn50ds108y.apifox.cn/api-217020149.md): 检索已登录客户保存的付款方式。此API路由仅适用于使用不推荐使用的支付服务接口创建的支付提供商。支付方式是使用支付服务的第三方服务保存的，而不是在美杜莎后端。因此，它们是从第三方服务中检索的。
- 商城 API > 客户信息 [添加送货地址](https://wn50ds108y.apifox.cn/api-217020150.md): 将送货地址添加到客户的保存地址中。
- 商城 API > 客户信息 [更新客户](https://wn50ds108y.apifox.cn/api-217020151.md): 更新登录客户的详细信息。
- 商城 API > 客户信息 [获取客户](https://wn50ds108y.apifox.cn/api-217020152.md): 检索登录客户的详细信息。
- 商城 API > 客户信息 [更新送货地址](https://wn50ds108y.apifox.cn/api-217020153.md): 更新登录客户的保存的送货地址的详细信息。
- 商城 API > 客户信息 [删除地址](https://wn50ds108y.apifox.cn/api-217020154.md): 从客户的保存地址中删除地址。
- 商城 API > 客户信息 [创建客户](https://wn50ds108y.apifox.cn/api-217020155.md): 注册新客户。这也将自动对客户进行身份验证，并在响应Cookie标头中设置他们的登录会话。cookie会话可以在随后的请求中用于对客户进行身份验证。当使用美杜莎的JS或美杜莎React客户端时，cookie会自动附加到后续请求中。
- 商城 API > 客户信息 [重置密码](https://wn50ds108y.apifox.cn/api-217020156.md): 使用先前通过请求密码重置 API 路由创建的密码令牌重置客户的密码。如果密码令牌已过期，则必须创建一个新的。
- 商城 API > 客户信息 [获取订单列表](https://wn50ds108y.apifox.cn/api-217020157.md): 检索登录客户的订单列表。订单可以通过诸如 `status` 或 `fulfillment_status` 之类的字段进行过滤。订单也可以分页。
- 商城 API > 产品变体 [获取产品变体](https://wn50ds108y.apifox.cn/api-217020158.md): 检索产品变体的详细信息。为了根据客户的上下文准确地为产品变体定价，强烈建议在可用时传递以下字段：
- 商城 API > 产品变体 [获取产品变体](https://wn50ds108y.apifox.cn/api-217020159.md): 检索产品变体列表。产品变体可以通过诸如 `id` 或 `title` 之类的字段进行过滤。产品变体也可以分页。
- 商城 API > 产品标签 [获取产品标签列表](https://wn50ds108y.apifox.cn/api-217020160.md): 检索产品标签列表。产品标签可以通过诸如 `id` 或 `q` 之类的字段进行过滤。产品标签也可以排序或分页。
- 商城 API > 产品类别 [获取产品类别列表](https://wn50ds108y.apifox.cn/api-217020161.md): 检索产品类别列表。产品类别可以通过诸如 `handle` 或 `q` 之类的字段进行过滤。产品类别也可以分页。此 API 路由还可用于按句柄检索产品类别。
- 商城 API > 产品类别 [获取产品类别](https://wn50ds108y.apifox.cn/api-217020162.md): 检索产品类别的详细信息。
- 商城 API > 收款 [授权付款会话](https://wn50ds108y.apifox.cn/api-217020163.md): 授权付款集合的付款会话。
- 商城 API > 收款 [授权支付会话](https://wn50ds108y.apifox.cn/api-217020164.md): 授权支付集合的支付会话。
- 商城 API > 收款 [刷新支付会话](https://wn50ds108y.apifox.cn/api-217020165.md): 刷新支付会话的数据以确保其与支付集合同步。
- 商城 API > 收款 [获取支付集合](https://wn50ds108y.apifox.cn/api-217020166.md): 检索支付集合的详细信息。
- 商城 API > 收款 [管理支付会话](https://wn50ds108y.apifox.cn/api-217020167.md): 创建、更新或删除付款集合的支付会话列表。如果在 `sessions` 数组中未提供支付会话，则会将其删除。
- 商城 API > 收款 [创建支付会话](https://wn50ds108y.apifox.cn/api-217020168.md): 在付款集合中为付款提供程序创建支付会话。
- 商城 API > 产品体系 [获取产品集合](https://wn50ds108y.apifox.cn/api-217020169.md): 检索产品集合的详细信息。
- 商城 API > 产品体系 [获取产品集合列表](https://wn50ds108y.apifox.cn/api-217020170.md): 检索产品集合的列表。产品集合可以通过“handle”或“created_at”等字段进行筛选。产品集合也可以进行分页。
- 商城 API > 产品类型 [获取产品类型列表](https://wn50ds108y.apifox.cn/api-217020171.md): 检索产品类型列表。产品类型可以通过诸如 `value` 或 `q` 之类的字段进行过滤。产品类型也可以排序或分页。
- 商城 API > 订单编辑 [完成订单编辑](https://wn50ds108y.apifox.cn/api-217020172.md): 完成订单编辑并将其更改反映到原始订单上。任何需要的额外付款必须先使用付款集合 API 路由授权。
- 商城 API > 订单编辑 [检索订单编辑](https://wn50ds108y.apifox.cn/api-217020173.md): 检索订单编辑的详细信息。
- 商城 API > 订单编辑 [拒绝订单编辑](https://wn50ds108y.apifox.cn/api-217020174.md): 拒绝订单编辑。更改不会反映在原始订单上。
- 商城 API > 退货 [创建退货](https://wn50ds108y.apifox.cn/api-217020175.md): 为订单创建退货。如果指定了退货运送方式，则退货会自动完成。
- 商城 API > 退货原因 [获取退货原因列表](https://wn50ds108y.apifox.cn/api-217020176.md): 检索退货原因列表。这在店面中实现创建退货流程时非常有用。
- 商城 API > 退货原因 [获取退货原因](https://wn50ds108y.apifox.cn/api-217020177.md): 检索退货原因的详细信息。
- 商城 API > 购物车 [创建支付会话](https://wn50ds108y.apifox.cn/api-217020178.md): 为购物车所在地区的每个可用支付提供程序创建支付会话。如果只创建了一个支付会话，则默认情况下会选择该会话。支付会话的创建使用支付提供程序，并且可能需要向第三方服务发送请求。
- 商城 API > 购物车 [刷新支付会话](https://wn50ds108y.apifox.cn/api-217020179.md): 刷新支付会话以确保它与购物车同步。这通常是不必要的，但提供给边缘情况。
- 商城 API > 购物车 [创建购物车](https://wn50ds108y.apifox.cn/api-217020180.md): 创建购物车。虽然是可选的，但指定购物车的地区和销售渠道可能会影响购物车的定价和
- 商城 API > 购物车 [完成购物车](https://wn50ds108y.apifox.cn/api-217020181.md): 完成购物车并根据购物车的类型下订单或创建交换。这包括尝试授权购物车的付款。
- 商城 API > 购物车 [选择支付会话](https://wn50ds108y.apifox.cn/api-217020182.md): 选择将用于完成购物车的支付会话。这通常在客户在结账期间选择其首选付款方式时使用。购物车的总计将重新计算。
- 商城 API > 购物车 [删除支付会话](https://wn50ds108y.apifox.cn/api-217020183.md): 删除购物车中的支付会话。如果付款失败，这可能会有用。总计将重新计算。
- 商城 API > 购物车 [更新支付会话](https://wn50ds108y.apifox.cn/api-217020184.md): 使用其他数据更新支付会话。根据使用的支付提供程序，这可能会有用。之后所有支付会话都将更新，并重新计算购物车总计。
- 商城 API > 购物车 [获取购物车](https://wn50ds108y.apifox.cn/api-217020185.md): 检索购物车的详细信息。这包括重新计算其总计。
- 商城 API > 购物车 [更新购物车](https://wn50ds108y.apifox.cn/api-217020186.md): 更新购物车的详细信息。如果购物车具有支付会话并且未更改地区，则支付会话将更新。购物车的总计也 将重新计算。
- 商城 API > 购物车 [添加送货方式](https://wn50ds108y.apifox.cn/api-217020187.md): 向购物车添加送货方式。`data` 字段的验证由所选送货选项的配送提供程序处理。
- 商城 API > 购物车 [更新订单项](https://wn50ds108y.apifox.cn/api-217020188.md): 更新订单项的数量。
- 商城 API > 购物车 [删除订单项](https://wn50ds108y.apifox.cn/api-217020189.md): 从购物车中删除订单项。支付会话将更新，总计将重新计算。
- 商城 API > 购物车 [添加订单项](https://wn50ds108y.apifox.cn/api-217020190.md): 使用给定的产品变体生成订单项并将其添加到购物车
- 商城 API > 购物车 [计算购物车税费](https://wn50ds108y.apifox.cn/api-217020191.md): 计算购物车的税费。如果购物车的地区的 `automatic_taxes` 字段设置为 `false`，则此方法很有用。如果购物车的地区使用除 Medusa 的系统提供程序之外的税费提供程序，则这可能会导致向第三方服务发送请求。
- 商城 API > 购物车 [删除折扣](https://wn50ds108y.apifox.cn/api-217020192.md): 从购物车中删除折扣。这只会删除折扣的应用，而不会完全删除它。删除后，总计将重新计算，并且支付会话将刷新。
- 商城 API > 身份验证 [客户登录 (JWT)](https://wn50ds108y.apifox.cn/api-217020193.md): 成功登录后，将返回一个 JWT 令牌以用于后续授权。
- 商城 API > 身份验证 [客户登录 (JWT)](https://wn50ds108y.apifox.cn/api-217020194.md): 成功登录后，将返回一个JWT令牌，该令牌可用于发送经过身份验证的请求。
- 商城 API > 身份验证 [检查电子邮件是否存在](https://wn50ds108y.apifox.cn/api-217020195.md): 检查是否已有客户使用提供的电子邮件注册。
- 商城 API > 身份验证 [获取当前客户](https://wn50ds108y.apifox.cn/api-217020196.md): 检索当前登录客户的详细信息。
- 商城 API > 身份验证 [客户登出](https://wn50ds108y.apifox.cn/api-217020197.md): 删除当前登录客户的会话。
- 商城 API > 身份验证 [客户登录](https://wn50ds108y.apifox.cn/api-217020198.md): 让客户登录并在响应标头中包含Cookie会话。cookie会话可以在随后的请求中用于对客户进行身份验证。当使用美杜莎的JS或美杜莎React客户端时，cookie会自动附加到后续请求中。
- 商城 API > 物流选项 [获取购物车可用物流选项列表](https://wn50ds108y.apifox.cn/api-217020199.md): 检索购物车可用的物流选项列表。
- 商城 API > 物流选项 [获取物流选项](https://wn50ds108y.apifox.cn/api-217020200.md): 检索物流选项列表。
- 商城 API > 订单 [声明订单](https://wn50ds108y.apifox.cn/api-217020201.md): 允许登录的客户声明一个或多个订单的所有权。这将生成一个令牌，以后可以使用该令牌通过验证订单声明 API 路由来验证声明。这也会发出 `order-update-token.created` 事件。因此，如果您安装了处理此事件并向客户发送通知（例如电子邮件）的通知提供程序，则客户应会收到有关如何完成其声明所有权的说明。
- 商城 API > 订单 [验证订单声明](https://wn50ds108y.apifox.cn/api-217020202.md): 验证在客户请求订单所有权时提供给客户的索赔订单令牌。
- 商城 API > 订单 [获取订单](https://wn50ds108y.apifox.cn/api-217020203.md): 检索订单的详细信息。
- 商城 API > 订单 [查找订单](https://wn50ds108y.apifox.cn/api-217020204.md): 使用过滤器查找订单。如果过滤器没有将结果缩小到单个订单，则返回 404 响应，表示没有订单。
- 商城 API > 订单 [按购物车 ID 获取](https://wn50ds108y.apifox.cn/api-217020205.md): 按用于创建订单的购物车的 ID 检索订单的详细信息。
- 商城 API > 交换 [按购物车ID获取](https://wn50ds108y.apifox.cn/api-217020206.md): 按其购物车的 ID 检索 Swap 的详细信息。
- 商城 API > 交换 [创建交换](https://wn50ds108y.apifox.cn/api-217020207.md): 为订单创建交换。这也将创建一个返回，并将其与交换相关联。如果指定了退货运输选项，退货将自动完成。
- 商城 API > 礼品卡 [按代码获取礼品卡](https://wn50ds108y.apifox.cn/api-217020208.md): 按其关联的唯一代码检索礼品卡的详细信息。
- 商城 API > WebSocket [WebSocket](https://wn50ds108y.apifox.cn/websocket-3569139.md): 
- 商城 API > 宠物 [上传宠物图片](https://wn50ds108y.apifox.cn/api-229684784.md): 
- 商城 API > 宠物 [根据 tag 查找宠物列表](https://wn50ds108y.apifox.cn/api-229684785.md): 
- 商城 API > 用户 [查询用户信息](https://wn50ds108y.apifox.cn/api-229684792.md): 获取单个用户的个人资料信息，仅已登录用户可查询。
- 商城 API > 用户 [获取用户列表](https://wn50ds108y.apifox.cn/api-229684798.md): 
- 商城 API > 用户 [修改用户信息](https://wn50ds108y.apifox.cn/api-229684793.md): 修改用户资料，仅可修改本人资料，不可修改他人资料。
- 商城 API > 用户 [登录](https://wn50ds108y.apifox.cn/api-229684794.md): 
- 商城 API > 用户 [注册](https://wn50ds108y.apifox.cn/api-229684795.md): 
- 商城 API > 用户 [退出登录](https://wn50ds108y.apifox.cn/api-229684796.md): 
- 商城 API > 用户 [删除用户](https://wn50ds108y.apifox.cn/api-229684797.md): 
- 商城 API > 用户 [用户详情](https://wn50ds108y.apifox.cn/api-229684799.md): 
- 商城 API > 店铺 [加入购物车](https://wn50ds108y.apifox.cn/api-229684790.md): 
- 商城 API > 店铺 [下单购买宠物](https://wn50ds108y.apifox.cn/api-229684787.md): 
- 商城 API > 店铺 [支付订单](https://wn50ds108y.apifox.cn/api-229684791.md): 
- 商城 API > 店铺 [新建宠物信息](https://wn50ds108y.apifox.cn/api-230953676.md): 
- 商城 API > 店铺 [查询订单详情](https://wn50ds108y.apifox.cn/api-229684788.md): 
- 商城 API > 店铺 [根据状态查询宠物库存数](https://wn50ds108y.apifox.cn/api-229684786.md): 
- 商城 API > 店铺 [删除订单](https://wn50ds108y.apifox.cn/api-229684789.md): 
- 加密解密 [加密解密](https://wn50ds108y.apifox.cn/api-256962957.md): 
- 用户问题测试 [A&B](https://wn50ds108y.apifox.cn/api-257246667.md): 
- 用户问题测试 [oneOf](https://wn50ds108y.apifox.cn/api-263045814.md): 
- 用户问题测试 [宠物](https://wn50ds108y.apifox.cn/api-273560973.md): 
- 用户问题测试 [11](https://wn50ds108y.apifox.cn/api-273571110.md): 
- 调用外部程序 [调用外部程序](https://wn50ds108y.apifox.cn/api-268522592.md): 
- WebSocket [WebSocket](https://wn50ds108y.apifox.cn/websocket-3603699.md): 
- OpenAPI Security Schemes 导入示例 [公开接口，无需认证](https://wn50ds108y.apifox.cn/api-278710147.md): 
- OpenAPI Security Schemes 导入示例 [获取用户列表](https://wn50ds108y.apifox.cn/api-278702104.md): 
- OpenAPI Security Schemes 导入示例 [创建新用户](https://wn50ds108y.apifox.cn/api-278702105.md): 
- OpenAPI Security Schemes 导入示例 [管理员接口](https://wn50ds108y.apifox.cn/api-278702106.md): 
- OpenAPI Security Schemes 导入示例 [管理员获取全部用户详细信息](https://wn50ds108y.apifox.cn/api-278710148.md): 
- OpenAPI Security Schemes 导入示例 [获取系统指标](https://wn50ds108y.apifox.cn/api-278710149.md):