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

获取商品列表(仅获取前N个)

POST
https://api.rmao.cn/goods/goodsitemstop

请求参数

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/goods/goodsitemstop' \
--header 'AccessToken: EGfRJ2kF7Yp35Kr9Waj6nOoqLZChAB73HQde8fWcW3GkqEg5VmBjan49fISC2LHBwtt724jZ4kbd7DQ8FrDdAbrHC+SUG8/y5oKT46fZ+8iLBHZRloTjL3WK00lM54pVxvn5qtTSL8b1AAY3Judst2oDriiUqV2Jf2WsKinRx9P5Y7IzHtffCuTRmCIgsng0wnlbaDikLAKzqrjziP/h5IAFoQkN1FN9nN4CyTDTwC2mgSBjtagrDMVyoqPT12+rAhvZ1Li8Z6SZfeUySYckAHHtuYeZHI3OT7iuug1pf+nF7DTtc+TUdOiFU478DGp3mDtwaKnZXtI0SVf+MJvU/Q==' \
--form 'userId="cadd4401-32d3-46c9-abde-825af9a79285"' \
--form 'userCode="0XpJGSsJZd7Cy98eLBXI42"' \
--form 'search="茶"' \
--form 'typeId="d90f1e63-2e8b-4cf5-8619-b513933f25c1"' \
--form 'brandId="161e9c0f-8964-476b-97d8-236f844d70c7"' \
--form 'activeType=""' \
--form 'sort=""' \
--form 'count=""' \
--form 'getBrands=""'

返回响应

🟢200成功
application/json
Body

示例
{
    "code": 1,
    "codeEn": "SUCCESS",
    "msg": "请求成功",
    "requestId": "7034062f-07cf-4762-983e-6231c8b867d2",
    "time": 1765361127640,
    "randStr": "sihud28usbid_1sn",
    "sign": "698d51a19d8a121ce581499d7b701668",
    "data": {
        "goodsItems": {
            "goodsId": "1e520027-906d-4f58-badc-4715399ad6f9",
            "activeType": 1,
            "allowBuyWithoutActive": false,
            "t_ActiveBegin": "2025/12/24 00:00:00",
            "t_ActiveEnd": "2026/12/24 00:00:00",
            "t_PreSend": "2026/01/24 00:00:00",
            "onSale": true,
            "name": "软猫茶杯",
            "orgnPriceRange": {
                "min": 10000,
                "max": 20000
            },
            "priceRange": {
                "level": "344864d4-6408-41b5-9e7d-8ac5b2b48f65",
                "min": 5000,
                "max": 10000
            },
            "activePriceRange": {
                "level": "344864d4-6408-41b5-9e7d-8ac5b2b48f65",
                "min": 4000,
                "minIntegral": 23,
                "max": 8000,
                "maxIntegral": 98
            },
            "cover": "https://cdn.rmao.cn/mo/%E5%95%86%E5%93%81/%E6%A4%B0%E4%B9%B3%E6%8B%BF%E9%93%81/1.jpg",
            "brandId": "f7b92de5-bd45-4372-bff7-0b783265c0cc",
            "score": 455,
            "scoreNumber": 80,
            "sales": 999,
            "collects": 888,
            "limitBuyCount": 30,
            "singleLimitBuyCount": 2,
            "eachDayLimitBuyCount": 5,
            "eachWeekLimitBuyCount": 10,
            "eachMonthLimitBuyCount": 15,
            "eachQuarterLimitBuyCount": 20,
            "eachYearLimitBuyCount": 25,
            "addToShopCart": true,
            "keyWords": [
                "健康茶",
                "健康茶",
                "健康茶"
            ],
            "intro": "健康茶首先在西方流行。中国保健茶是以绿茶、红茶或乌龙茶为主要原料,配以确有疗效的单味或复方中药制成;也有用中药煎汁喷在茶叶上干燥而成;或者药液茶液浓缩喷专利权干燥而成。"
        },
        "brands": [
            {
                "id": "f7b92de5-bd45-4372-bff7-0b783265c0cc",
                "name": "软猫",
                "icon": "https://cdn.rmao.cn/lg/7.png"
            }
        ],
        "levelId": "344864d4-6408-41b5-9e7d-8ac5b2b48f65"
    }
}
修改于 2025-12-24 11:21:08
上一页
获取商品列表(分页获取)
下一页
获取完整的商品信息(用于商品详情页,不含款式数据)
Built with