订单接口

• 获取用户收货地址接口

  获取当前登录用户的收货地址信息，该接口会返回最近一次使用的收货地址。 注意事项 该接口采用GET方法，无需提交请求体数据 需要用户登录后才能访问 返回最近一次使用的收货地址信息 如果用户没有收货地址，返回空数据 请求地址 {域名地址}/api/order/address 说明：{域名地址} 需要替换成你的域名地址，如 https://www.anqicms

• 保存用户收货地址接口

  创建或更新用户的收货地址信息。 注意事项 该接口采用POST方法，需要以application/json格式提交数据 需要用户登录后才能访问 如果提供了ID参数，则更新现有地址；否则创建新地址 所有标记为必填的字段都需要提供值 请求地址 {域名地址}/api/order/address 说明：{域名地址} 需要替换成你的域名地址，如 https://www.anqicms

• 取消订单接口

  取消用户指定的订单，将订单状态更新为已取消。 注意事项 该接口采用POST方法，需要以application/json格式提交数据 需要用户登录后才能访问 只能取消属于当前用户的订单 订单必须处于可取消状态才能被取消 请求地址 {域名地址}/api/order/cancel 说明：{域名地址} 需要替换成你的域名地址，如 https://www.anqicms

• 创建订单接口

  创建用户购物订单，支持单个商品或多个商品下单，可指定收货地址、优惠券等信息。 注意事项 该接口采用POST方法，需要以application/json格式提交数据 需要用户登录后才能访问 订单状态为待付款状态，等待用户支付 可以通过商品ID或商品详情列表创建订单 支持使用优惠券和指定收货地址 请求地址 {域名地址}/api/order/create 说明：{域名地址} 需要替换成你的域名地址

• 获取订单详情接口

  获取指定订单的详细信息，包括订单状态、商品信息、收货地址等完整订单数据。 注意事项 该接口采用GET方法，无需提交请求体数据 需要用户登录后才能访问 只能获取属于当前用户的订单详情 返回完整的订单信息、商品详情和收货地址信息 请求地址 {域名地址}/api/order/detail 说明：{域名地址} 需要替换成你的域名地址，如 https://www.anqicms

• 订单确认收货接口

  允许用户确认订单已收货，将订单状态更新为已完成。 注意事项 该接口采用POST方法，需要以application/json格式提交数据 需要提供订单ID作为确认收货的标识 仅登录用户可以调用此接口 订单必须处于”已发货”状态才能确认收货 确认收货后订单状态将变为”已完成” 请求地址 {域名地址}/api/order/finish 说明：{域名地址}

• 订单创建支付接口

  为待支付的订单创建支付，支持多种支付方式，包括微信、微信小程序、支付宝、PayPal和Stripe。 注意事项 该接口采用POST方法，需要以application/json格式提交数据 需要提供订单ID和支付方式 仅登录用户可以调用此接口 订单必须处于”待支付”状态才能创建支付 根据不同的支付方式返回相应的支付信息（二维码、跳转链接或小程序支付参数） 请求地址

• 订单申请退款接口

  允许用户为已完成或已支付的订单申请退款，提交退款申请后等待管理员审核处理。 注意事项 该接口采用POST方法，需要以application/json格式提交数据 需要提供订单ID作为退款申请的标识 仅登录用户可以调用此接口 订单必须处于”已完成”或”已支付”状态才能申请退款 申请退款后订单状态将变为”退款中”

• 获取订单列表接口

  获取用户的订单列表，支持按订单状态筛选和分页查询。 注意事项 该接口采用GET方法 需要用户登录验证 支持按订单状态筛选（待付款、已付款、已发货、已完成等） 支持分页查询，默认每页数量由pageSize参数决定 只返回当前登录用户的订单信息 请求地址 {域名地址}/api/orders 说明：{域名地址} 需要替换成你的域名地址，如 https://www.anqicms

• 检查订单是否支付接口

  检查指定订单的支付状态，确认订单是否已完成支付。 注意事项 该接口采用GET方法 需要提供订单ID参数 需要用户登录验证（验证订单是否属于当前用户） 返回订单的支付状态信息 只能查询当前用户自己的订单 请求地址 {域名地址}/api/payment/check 说明：{域名地址} 需要替换成你的域名地址，如 https://www.anqicms.com/api/payment/check

• 获取订单统计数据接口

  获取当前用户的订单统计数据，包括各种状态的订单数量统计。 注意事项 该接口采用GET方法 需要用户登录验证 返回当前用户的订单统计信息 包含各种订单状态的数量统计 包含愿望清单数量统计 请求地址 {域名地址}/api/orders/statistics 说明：{域名地址} 需要替换成你的域名地址，如 https://www.anqicms.com/api/orders/statistics

• 获取订单统计图表接口

  获取订单统计图表数据，支持按不同订单状态查询历史趋势。 注意事项 该接口采用GET方法 需要用户登录验证 支持查询不同订单状态的数据（待付款、待发货、待收货等） 返回指定时间范围内的订单统计趋势数据 数据以日期为维度，包含订单数量统计 请求地址 {域名地址}/api/orders/chart 说明：{域名地址} 需要替换成你的域名地址，如 https://www.anqicms

• 获取商品Checkout信息接口

  获取商品结算信息，支持单个商品或多个商品的订单结算，包含优惠计算、地址信息等。 注意事项 该接口采用POST方法，需要以application/json格式提交数据 支持单个商品下单（通过goods_id、quantity、goods_sku_id参数）或多个商品下单（通过details参数） 支持使用优惠券（优惠券码或优惠券ID） 需要用户登录验证 支持设置收件地址和订单备注 请求地址

• 获取订单地址列表接口

  API 调用地址 {域名地址}/api/order/addresses 说明：{域名地址} 需要替换成你的域名地址，如 https://www.anqicms.com/api/order/addresses 调用方法 GET 请求参数 无 返回参数 字段名 类型 说明 code int 错误码 msg string 错误原因说明 data object[] 结果内容 data 结果的 item

• 获取愿望清单列表接口

  获取当前登录用户的愿望清单列表，支持分页查询，返回用户收藏的商品信息。 注意事项 该接口采用GET方法，无需请求体 需要用户已登录，通过会话或Token验证身份 支持分页查询，可通过参数控制每页显示数量和当前页码 返回愿望清单中商品的详细信息，包括价格、备注等 包含商品当前价格和添加时的价格对比 请求地址 {域名地址}/api/wishlist/list 说明：{域名地址}

• 添加愿望清单接口

  将指定商品添加到用户的愿望清单中，支持设置备注、价格、优先级等信息。 注意事项 该接口采用POST方法，需要以application/json格式提交数据 需要提供商品ID，可选择性提供SKU ID 需要用户已登录，通过会话或Token验证身份 可以设置愿望价格、备注和优先级 如果商品已在愿望清单中，则可能更新现有记录 请求地址 {域名地址}/api/wishlist/add 说明：{域名地址}

• 移除愿望清单接口

  从用户的愿望清单中删除指定的商品记录。 注意事项 该接口采用POST方法，需要以application/json格式提交数据 需要提供愿望清单记录ID 需要用户已登录，通过会话或Token验证身份 只能删除属于当前用户愿望清单中的记录 删除操作不可逆，请谨慎操作 请求地址 {域名地址}/api/wishlist/delete 说明：{域名地址} 需要替换成你的域名地址，如 https

• 获取可用优惠券列表接口

  获取当前用户当前情况下可以使用的优惠券列表，支持按订单金额和商品ID筛选。 注意事项 该接口用于获取当前用户可用的优惠券列表 可通过amount参数筛选适用于指定金额订单的优惠券 可通过archive_id参数筛选适用于指定商品的优惠券 需要用户登录后才能获取优惠券列表 需要确保域名地址正确配置 返回的是当前时间有效且未使用的优惠券 优惠券的有效性包括时间范围、使用条件等限制 请求地址

• 获取我的优惠券列表接口

  获取当前用户已领取的优惠券列表，支持分页显示和状态筛选功能。 注意事项 该接口用于获取当前用户的优惠券列表信息 支持分页查询，可通过current和pageSize参数控制分页 支持按状态筛选优惠券（未使用、已使用或全部） 需要用户登录后才能获取优惠券列表 需要确保域名地址正确配置 返回结果包含总数信息，便于前端分页处理 请求地址 {域名地址}/api/coupon/codes 说明

• 领取优惠券接口

  允许用户领取指定的优惠券，通过提供优惠券ID来获取优惠券。 注意事项 该接口采用POST方法，需要以application/json格式提交数据 需要提供有效的优惠券ID 用户需要登录才能领取优惠券 优惠券可能有领取数量限制或时间限制 需要确保域名地址正确配置 同一用户可能无法重复领取同一张优惠券 请求地址 {域名地址}/api/coupon/code 说明：{域名地址}

• 获取购物车列表接口

  API 调用地址 {域名地址}/api/cart/list 说明：{域名地址} 需要替换成你的域名地址，如 https://www.anqicms.com/api/cart/list 调用方法 GET Header 或者 Cookie 字段名 类型 必填 说明 cart string 否 当没有登录的时候，用此token作为用户判断 请求参数 字段名 类型 必填 说明 current int

• 添加购物车接口

  将指定商品添加到购物车中，支持指定商品 SKU、数量等信息，适用于电商功能中的购物车操作。 注意事项 该接口采用POST方法，需要以application/json格式提交数据 支持登录用户和未登录用户（通过 cart token 识别） 必须指定商品 ID 和数量 可以通过 SKU ID 指定具体的商品规格 如果商品已经在购物车中，则会更新数量而不是新增 请求地址

• 移除购物车商品接口

  从购物车中移除指定商品，根据购物车 ID 删除对应的购物车记录。 注意事项 该接口采用POST方法，需要以application/json格式提交数据 需要提供购物车记录的 ID 而不是商品 ID 支持登录用户和未登录用户（通过 cart token 识别） 删除成功后返回成功消息 请求地址 {域名地址}/api/cart/remove 说明：{域名地址} 需要替换成你的域名地址，如

• 更新购物车接口

  API 调用地址 {域名地址}/api/cart/update 说明：{域名地址} 需要替换成你的域名地址，如 https://www.anqicms.com/api/cart/update 调用方法 POST Header 或者 Cookie 字段名 类型 必填 说明 cart string 否 当没有登录的时候，用此token作为用户判断 请求参数 | 字段名 | 类型 | 必填| 说明

• 获取沟通定制订单字段接口

  获取沟通定制订单可用的自定义字段信息，用于在创建沟通定制订单时提供表单字段。 注意事项 该接口采用GET方法，无需提交请求体数据 无需登录即可访问 返回所有可用的沟通定制订单字段配置 包含字段名称、类型、是否必填等信息 请求地址 {域名地址}/api/communication/fields 说明：{域名地址} 需要替换成你的域名地址，如 https://www.anqicms

• 获取沟通定制订单列表

  获取用户沟通定制订单的列表信息，支持分页查询。 注意事项 该接口采用GET方法，无需提交请求体数据 需要用户登录后才能访问 返回当前用户的所有沟通定制订单 支持分页查询，可指定当前页码和每页数量 请求地址 {域名地址}/api/communication/orders 说明：{域名地址} 需要替换成你的域名地址，如 https://www.anqicms

• 创建沟通定制订单接口

  创建沟通定制订单，用于用户提交定制需求，等待商家确认。 注意事项 该接口采用POST方法，需要以application/json格式提交数据 需要用户登录后才能访问 创建的订单需要商家确认后才能进入支付流程 订单状态为待确认状态，等待商家接受 请求地址 {域名地址}/api/communication/order/create 说明：{域名地址} 需要替换成你的域名地址，如 https

• 获取沟通定制订单详情接口

  获取沟通定制订单的详细信息，包括订单状态、沟通记录等。 注意事项 该接口采用GET方法，无需提交请求体数据 返回完整的订单信息和沟通记录 请求地址 {域名地址}/api/communication/order/detail 说明：{域名地址} 需要替换成你的域名地址，如 https://www.anqicms.com/api/communication/order/detail 请求语法

• 更新沟通定制订单接口

  更新沟通定制订单的基本信息，包括标题、内容和订单额外信息。 注意事项 该接口采用POST方法，需要以application/json格式提交数据 需要用户登录后才能访问 只能更新属于当前用户的订单 订单ID为必填参数，用于指定要更新的订单 请求地址 {域名地址}/api/communication/order/update 说明：{域名地址} 需要替换成你的域名地址，如 https://www

• 沟通定制订单接受报价接口

  注意事项 该接口采用POST方法，需要以application/json格式提交数据 需要用户登录后才能访问 订单状态为待付款状态，等待用户支付 可以通过商品ID或商品详情列表创建订单 该接口与创建订单接口参数相同，专门用于接受定制订单 请求地址 {域名地址}/api/communication/order/accept 说明：{域名地址} 需要替换成你的域名地址，如 https://www

• 获取沟通定制订单沟通信息列表接口

  获取指定沟通定制订单的沟通记录列表，支持分页查询。 注意事项 该接口采用GET方法，无需提交请求体数据 需要用户登录后才能访问 只能获取属于当前用户订单的沟通记录 支持分页查询，可指定当前页码和每页数量 请求地址 {域名地址}/api/communication/messages 说明：{域名地址} 需要替换成你的域名地址，如 https://www.anqicms

• 发送沟通定制订单信息接口

  向指定的沟通定制订单发送消息，用于用户和管理员之间的沟通交流。 注意事项 该接口采用POST方法，需要以application/json格式提交数据 需要用户登录后才能访问 只能向属于当前用户的订单发送消息 支持多种消息类型：文本、图片、报价、视频、文件等 请求地址 {域名地址}/api/communication/message/send 说明：{域名地址} 需要替换成你的域名地址，如

• 获取产品/订单评价列表接口

  获取产品或订单的评价列表，支持按商品、用户等条件筛选和分页查询。 注意事项 该接口采用GET方法 支持按商品ID、用户ID、订单ID等条件筛选 支持自定义排序方式 支持分页查询，默认每页10条记录 只返回已审核通过的评价（状态为1） 请求地址 {域名地址}/api/review/list 说明：{域名地址} 需要替换成你的域名地址，如 https://www.anqicms

• 发表产品/订单评价接口

  允许用户对已购买的产品或订单进行评价，支持文字评价、评分和图片上传。 注意事项 该接口采用POST方法，需要以application/json格式提交数据 需要提供文档ID和评价内容 支持登录用户和未登录用户（未登录用户需提供用户名） 可以通过订单ID关联评价特定订单 支持1-5分的评分系统 支持上传多张评价图片 评价需要审核后才能显示 请求地址