获取用户权益次数接口 - YHOUSE-SH/yhouse-thirdpart GitHub Wiki

  1. 接口说明:

    • 使用场景: 获取用户权益次数接口
    • 授权说明: 悦会提供授权商户号和密钥
    • 接口请求方式: POST
    • 数据格式: JSON
    • 访问限制:
      • YHOUSE授权商户(指定渠道可用)
        • 授权商户号 (YHOUSE提供)
        • 授权商户密钥 (YHOUSE提供)
  2. 接口地址

  3. 请求头信息:

    • Accept:application/json;charset=UTF-8
    • Content-Type:application/json
  4. 请求参数信息:

    参数名 类型 必填 说明 示例
    timestamp Long Y 当前unix时间戳(包含毫秒) 1560851373957
    partnerNo String Y 悦会提供的商户号 PN0001
    sign String Y 参数签名 B59C67BF196A4758191E42F76670CEBA
    uid String Y 商户平台用户ID XS124243444

  1. 请求返回

正常返回示例:

{
  "code": "0",
  "data": [
    {
      "cardName": "会员all",//卡档位名称
      "equities": [
        {
          "times": -1, // 权益剩余次数 -1 表示无限次 
          "name": "轻奢饮食", //权益分类名称
          "id": "A25145440" //权益分类ID
        },
        {
          "times": 8,
          "name": "美容spa",
          "id": "A25145471-E25545444"
        }
      ],
      "id": 43939526,//卡包ID
      "activationTime": "2019-09-03",//开卡时间
      "skuId": "L727",//三方skuId
      "expiredTime": "2020-03-05" //过期时间
    }
  ],
  "detail": "",
  "message": "success"
}

异常返回示例

    {
	"code": "P10000",
	"message": "success",
	"detail": "参数uid为空",
	"data": null
    }
⚠️ **GitHub.com Fallback** ⚠️