淘宝开放平台

登录
文档中心 > API类目 > XSPACE餐饮行业服务API

XSPACE餐饮行业服务API

qimen.alibaba.cco.xspace.catering.memberpoints.redeemlist.get (XSpace工作台获取兑换的积分列表)

获取餐饮行业客户会员兑换的积分

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
foreignId String 必须 e3oddir184931d 商户会员id，会员唯一标识
startDate String 可选 2020-12-12 12:12:12 积分消耗列表搜索开始的日期
endDate String 可选 2021-12-12 12:12:!2 积分消耗列表搜索结束的日期
pageNo Number 必须 1 分页码，1开始
pageSize Number 必须 40 每页的数据数量

响应参数

名称 类型 示例值 描述
result Result 业务接口响应结果
  • pointsList
  • PointsItem []
  • 获取积分列表
  • └ redeemChannel
  • String
  • ORDER
  • 兑换渠道，如订单，活动
  • └ redeemOrderId
  • String
  • 2022183991793918
  • 兑换订单id，如渠道是订单
  • └ redeemDate
  • String
  • 2020-1-23 12:12:12
  • 兑换时间
  • └ pointsUnit
  • String
  • 分
  • 积分单位，如星星，分，点等
  • └ pointsAmount
  • Number
  • 300
  • 兑换的积分数量
  • └ pointsDetailed
  • String
  • 活动兑换-杯型升级券
  • 积分明细(积分消耗明细)
  • └ pageNo
  • Number
  • 1
  • 分页页码
  • └ pageSize
  • Number
  • 40
  • 分页每页数量
  • └ totalCount
  • Number
  • 329
  • 记录总条数
msgCode Number 200 返回错误码，和http status保持概念相同
errorSubCode String points-server-error 错误子码
errorSubMessage String 积分服务错误 具体错误描述

请求示例

{"foreignId":"e3oddir184931d","endDate":"2021-12-12 12:12:!2","pageNo":1,"pageSize":40,"startDate":"2020-12-12 12:12:12"}

响应示例

{
    "result":{
        "pointsList":[
            {
                    "redeemChannel":"ORDER",
                    "redeemOrderId":"2022183991793918",
                    "redeemDate":"2020-1-23 12:12:12",
                    "pointsUnit":"分",
                    "pointsAmount":300,
                    "pointsDetailed":"活动兑换-杯型升级券"
            }
        ],
        "pageNo":1,
        "pageSize":40,
        "totalCount":329
    },
    "msgCode":200,
    "errorSubCode":"points-server-error",
    "errorSubMessage":"积分服务错误"
}

验签示例

{"errorSubCode":"sign-check-failure","errorSubMessage":"Illegal request","msgCode":"不等于200"}

错误码解释

错误码 错误描述 解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问
返回
顶部