文档中心 > API类目 > 客户运营平台API

qimen.alibaba.cem.member.reward.query (会员个性化权益礼查询)

从服务商/品牌商处查询会员的个性化权益礼

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
site String 必须 taobao 账号类型
open_id String 必须 123123 账号openId
union_id String 可选 34343 账号unionId
data String 必须 {"externalId":""} 查询参数
page_num String 可选 0
  • 默认值:0
  • 第几页
    page_size String 可选 10
  • 默认值:10
  • 每页数量
    Authorization String 可选 bearer d756377c-1bab-4923-918e-137fca09f222 bearerToken

    响应参数

    名称 类型 示例值 描述
    message String 账号不存在 接口异常消息
    data String { "benefitId": "7", "alternativeDescription": "升杯邀请券", "description": "Size Upgrade", "expiryDate": "04/22/2018", "issueDate": "01/22/2018", "manuallyAddedReason": null, "manuallyAddedUserName": null, "memberBenefitId": "1-7A3BQYV", "quantity": "1", "redeemedDate": null, "startDate": "01/22/2018", "status": "Available", "usageDescription": "This reward is subject to the following conditions: <br>1. Valid for one complimentary size upgrade beverage from Tall (12 ounce) to Grande (16 ounce) or from Grande (16 ounce) to Venti (20 ounce). <br>2. Not valid in conjunction with any other promotions/offers. <br>3. No cash value in exchange.", "alternativeUsageDescription": "好礼使用规则:<br>1.使用此电子兑换券您可以享受免费升级一杯手工调制的饮料,即中杯(12盎司)升级到大杯(16盎司),或大杯(16盎司)升级到特大杯(20盎司)。<br>2.此电子兑换券不可与店内其他优惠活动同享,不可兑换现金。" } 个性化权益礼数据
    code String SUC 接口异常码
    success Boolean true 接口是否成功

    请求示例

    1
    {"Authorization":"bearer d756377c-1bab-4923-918e-137fca09f222","site":"taobao","data":"{\"externalId\":\"\"}","open_id":"123123","union_id":"34343","page_num":"0","page_size":"10"}

    响应示例

    1
    2
    3
    4
    5
    6
    {
        "message":"账号不存在",
        "data":"{     \"benefitId\": \"7\",       \"alternativeDescription\": \"升杯邀请券\",     \"description\": \"Size Upgrade\",     \"expiryDate\": \"04\/22\/2018\",     \"issueDate\": \"01\/22\/2018\",     \"manuallyAddedReason\": null,     \"manuallyAddedUserName\": null,     \"memberBenefitId\": \"1-7A3BQYV\",     \"quantity\": \"1\",     \"redeemedDate\": null,     \"startDate\": \"01\/22\/2018\",     \"status\": \"Available\",     \"usageDescription\": \"This reward is subject to the following conditions: <br>1. Valid for one complimentary size upgrade beverage from Tall (12 ounce) to Grande (16 ounce) or from Grande (16 ounce) to Venti (20 ounce). <br>2. Not valid in conjunction with any other promotions\/offers. <br>3. No cash value in exchange.\",     \"alternativeUsageDescription\": \"好礼使用规则:<br>1.使用此电子兑换券您可以享受免费升级一杯手工调制的饮料,即中杯(12盎司)升级到大杯(16盎司),或大杯(16盎司)升级到特大杯(20盎司)。<br>2.此电子兑换券不可与店内其他优惠活动同享,不可兑换现金。\" }",
        "code":"SUC",
        "success":true
    }

    验签示例

    1
    {"code":"sign-check-failure","success":"不等于true","message":"Illegal request"}

    错误码解释

    错误码 错误描述 解决方案

    API工具

    FAQ

    返回
    顶部