软猫引擎API开放平台
  1. 退换货API
软猫引擎API开放平台
  • 接口安全API(必看)
    • 重要说明
    • 数据签名与验签方式
    • 获取AccessToken
      POST
  • 用户基础API
    • 获取永久用户标识
      • 获取永久用户标识UserId（根据临时用户标识userCode）
      • 获取永久用户标识UserId（根据已注册的手机号码）
    • 用户登录/退出
      • 发送短信验证码（用户登录）
      • 用户登录（通过短信验证码）
      • 用户登录（通过密码）
      • 用户退出登录
    • 用户注册
      • 发送短信验证码（用户注册）
      • 上传用户头像（用户注册）
      • 用户注册
    • 修改用户登录密码
      • 发送短信验证码(修改用户登录密码)
      • 修改用户登录密码
    • 修改用户安全密码
      • 发送短信验证码(修改用户安全密码)
      • 修改用户安全密码
    • 修改用户手机号码
      • 发送短信验证码(修改用户手机号码-新手机号码)
      • 发送短信验证码(修改用户手机号码-原手机号码)
      • 修改用户手机号码
    • 用户资料
      • 获取用户资料
      • 获取用户等级
      • 获取用户职称
      • 设置用户头像
      • 设置用户昵称
      • 设置用户性别
      • 设置用户所在地
    • 用户邀请人
      • 绑定邀请人（通过手机号码）
      • 绑定邀请人（通过手机号码） Copy
      • 绑定邀请人（通过手机号码） Copy Copy
    • 用户配置
      • 配置Key说明
      • 读取用户配置
      • 批量读取用户配置
      • 修改用户配置
  • 用户收件地址API
    • 获取用户的收件地址列表
      POST
    • 获取用户的收件地址（根据id获取）
      POST
    • 添加用户收件地址
      POST
    • 修改用户收件地址
      POST
    • 删除用户收件地址
      POST
    • 设置默认用户收件地址
      POST
  • 用户资产API
    • 余额配置
      • 配置Key说明
      • 读取余额配置
      • 批量读取余额配置
      • 修改余额配置
    • 积分配置
      • 配置Key说明
      • 读取积分配置
      • 批量读取积分配置
      • 修改积分配置
    • 代币配置
      • 配置Key说明
      • 读取代币配置
      • 批量读取代币配置
      • 修改代币配置
    • 用户转账
      • 根据收款人手机号码获取转账句柄（用于发起转账）
      • 根据收款人ID获取转账句柄（用于发起转账）
      • 根据收款人ID获取转账句柄（用于发起聚合转账）
      • 发起余额转账
      • 发起代币转账
      • 发起积分转账
      • 获取余额转账日志记录（转出）
      • 获取余额收款日志记录（转入）
      • 获取代币转账日志记录（转出）
      • 获取代币收款日志记录（转入）
      • 获取积分转账日志记录（转出）
      • 获取积分收款日志记录（转入）
    • 余额提现
      • 读取余额提现配置
      • 发起提现到银行卡
      • 发起提现到微信零钱
      • 取消提现到微信零钱
      • 获取提现到银行卡的日志记录
      • 获取提现到微信零钱的日志记录
      • 获取用户提现统计
    • 用户银行卡
      • 获取支持的银行列表
      • 验证银行卡号是否正确
      • 绑定用户银行卡
      • 解绑用户银行卡
      • 获取已绑定的用户银行卡列表
    • 获取用户资产（可用余额/冻结余额/积分/代币）
    • 获取用户余额明细日志
    • 获取用户积分明细日志
    • 获取用户代币明细日志
    • 获取用户冻结余额明细
    • 创建用户余额充值订单
  • 商品/分类/购物车/收藏/订单/退换货/评论句柄API
    • 商品API
      • 获取商品列表（分页获取）
      • 获取商品列表（仅获取前N个）
      • 获取完整的商品信息（用于商品详情页，不含款式数据）
      • 获取商品款式集合（用于客户端的商品款式选择器）
      • 获取商品分享卡片绘制数据
      • 获取微信小程序分享到聊天窗口的商品卡片图片（固定尺寸为800px*640px）
      • 读取线下销量/线下评论/线下收藏量的显示配置
      • 获取商品评价统计
      • 获取商品评价列表
      • 获取前N个正在进行的拼团（根据商品ID获取）
    • 商品分类API
      • 获取商品分类树
    • 购物车API
      • 获取购物车商品数量
      • 获取购物车商品列表
      • 更新购物车
      • 批量更新购物车（仅支持扣除，不支持增加）
    • 商品收藏API
      • 获取商品收藏列表
      • 切换商品收藏状态（收藏/取消收藏）
      • 批量取消收藏商品
    • 商品订单API
      • 生成订单提交句柄
      • 计算快递费
      • 提交并创建订单
      • 获取用户的商品订单数量
      • 获取用户的商品订单列表
      • 获取用户的商品订单详情
      • 修改订单收件地址
      • 取消订单
      • 签收订单
      • 读取订单收件信息（含收件地址、快递信息）
      • 读取拼团详情
    • 退换货API
      • 获取订单退/换货申请句柄
        POST
      • 获取订单退/换货详情
        POST
      • 上传图片（用于申请退/换货）
        POST
      • 发起订单退/换货申请
        POST
      • 取消订单退/换货申请
        POST
    • 评论句柄API
      • 获取用户的商品评论数量
      • 获取评论句柄列表
      • 获取评论句柄
      • 获取评论详情
      • 上传图片（用于发表商品评论）
      • 上传视频（用于发表商品评论）
      • 发表商品评论
      • 追加商品评论
      • 删除评论
    • 其他API
      • 获取用户最近买过的商品列表
      • 获取全商城最近的下单历史记录（用于客户端展示）
      • 汇总指定用户的订单
  • 文件API
    • 上传临时图片文件
    • 上传临时视频文件
    • 上传临时音频文件
  • 系统功能API
    • 功能Key说明
    • 获取所有已开通的功能列表
    • 验证是否已开通指定功能
  • 行政区划API
    • 获取省市区树
    • 获取省份列表(一级行政区划)
    • 获取城市列表(二级行政区划)
    • 获取区/县/镇列表(三级行政区划)
  • 收银台API
    • 获取订单支付句柄（用于发起支付）
    • 发起余额支付
    • 发起积分支付
    • 发起代币支付
    • 判断是否已开通微信支付
    • 发起微信支付
    • 判断(微信支付)订单是否已付款
    • 判断订单是否已付款
  • 商城配置API
    • 配置Key说明
    • 读取商城配置
    • 批量读取商城配置
    • 修改商城配置
  • 快递API
    • 获取快递公司列表
    • 获取所有快递计费规则
    • 判断是否指定区域是否开放配送
  • 数据模型
    • 标准响应模型
    • 标准数据分页模型
    • 用户银行卡数据模型
    • 用户收件地址数据模型
    • 基础商品数据模型（客户端专用）
    • 完整商品数据模型（客户端专用，不含款式数据和详情HTML）
    • 商品评论数据模型（客户端专用）
    • 商品款式集合数据模型（客户端专用）
    • 商品款式项数据模型（客户端专用）
    • 商品订单数据模型（客户端专用）
    • 商品订单中的商品数据模型（客户端专用）
  1. 退换货API

发起订单退/换货申请

POST
https://api.rmao.cn/goodsorder/returnapply
一个订单只能申请一次退/换货

请求参数

Header 参数

Body 参数multipart/form-data必填

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.rmao.cn/goodsorder/returnapply' \
--header 'AccessToken: oSjj37vPsYEW7nipcf7vAa5l5dIKxE0eQIJQETZ7KVtopfTRjOMiVMU0KFJDLSg1SfN3TcV8KGslA4WPTA14FrJiXldhDArxj9I4Kqu7CxLRh5ziwo97h8D0g1pqJVaF4UQrTJ/cqCVJdrSEYOPo/YLx1cUbnR1EBnD5eMQ+iDZjn+YxP8qjl/u+rB91aMH4kp0LYkZzr82fjaxx/HpDAe+T9+WV0+h6b2JjRzbNK8rWQvkainAU7IxS/HiC4q1fbN+fkkT24HVmbitg05ASKFSWjld3lIxdeWcsX+vTXNG6cQugOEzqEdMqLosDPkcc6oCkZI1l5Lh+vdjmDY1ktw==' \
--form 'userId="cadd4401-32d3-46c9-abde-825af9a79285"' \
--form 'userCode="0XpJGSsJZd7Cy98eLBXI42"' \
--form 'code="251228163246530085409428"' \
--form 'cost=""' \
--form 'remark="发错货了，已协调重发"' \
--form 'images="https://cdn.rmao.cn/mo/sys_files/temp/b3dc7840d672f5adcff1a3b6e4295f99.png"'

返回响应

🟢200成功
application/json
Body

示例
{
    "code": 1,
    "codeEn": "SUCCESS",
    "msg": "请求成功",
    "requestId": "0796ceb2-55f1-4c0f-9a3c-ac6e95e9cb11",
    "time": 1765361127640,
    "randStr": "sihud28usbid_1sn",
    "sign": "698d51a19d8a121ce581499d7b701668",
    "data": {
        "returnState": 2
    }
}
修改于 2025-12-29 05:59:59
上一页
上传图片（用于申请退/换货）
下一页
取消订单退/换货申请
Built with