开发指南
API
官网
API 2.0
API 2.0 > 2.3 储值 > 2.3.1 获取储值规则列表

2.3.1 获取储值规则列表

开启令牌和权限后可调用。签名方式请查看开发指南
场景描述：获取企迈云商当前店铺下的储值规则列表
零售 餐饮

请求地址

请求方式 版本信息 请求地址
POST V2 http://openapi.zvcms.com/api/v2

公共参数

参数 参数类型 是否必填 默认值 描述
OpenId string 是 密钥Id
GrantCode string 是 授权code
Token string 是 签名，参考《数字签名sign》
Timestamp string 是 当前时间戳
Nonce string 是 随机正整数
Action string 是 communal.user.rule-lists 接口方法
Params array 是 业务参数

请求参数

参数 参数类型 是否必填 默认值 描述
page int 否 1 当前页数
page_size int 否 10 当前页面记录数

响应参数

参数 参数类型 描述
status bool 成功或失败
code int 成功/错误编码
message string 成功/错误描述
data array
 ├current_page int 当前页数
 ├per_page int 每页显示数
 ├last_page int 最后一页
 ├total int 总页数
 ├cy_list array
  ├0 array
   ├id int 规则id
   ├name string 规则name
   ├image string 默认图片
   ├value Money(元) 储值卡金额
   ├sell_price Money(元) 销售价格
   ├desc string 说明描述
   ├status int 状态，0：弃用，1：启用
   ├sales int 销量
   ├created_at TimeStamp 创建时间
   ├updated_at TimeStamp 修改时间
   ├type string 0代表的是商家 1代表的是平台
   ├status_text string 状态描述
   ├full_image string 图片绝对路径
   ├gifts array
    ├0 array
     ├id int 礼品id
     ├recharge_card_id Int 主体id，recharge_cards表id
     ├type int 活动类型，Balance：赠送余额，Coupon：优惠券，Card：会员卡，Points：赠送积分
     ├ext array
      ├entity array
       ├0 array
        ├num int 数量1
        ├id Int 表示赠送余额20（或优惠券id为20） 跟type强关联
     ├created_at TimeStamp 创建时间
     ├updated_at TimeStamp 修改时间
     ├type_name string 类型名称

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "communal.user.rule-lists",
    "Params": {
        "page": "",
        "page_size": ""
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "current_page": "1",
        "per_page": "10",
        "last_page": "20",
        "total": "20",
        "cy_list": [
            {
                "id": "1",
                "name": "规则name",
                "image": "\/s1000106\/2018\/07\/09\/cfbc38cae535a8ad8a.jpeg",
                "value": "2",
                "sell_price": "2",
                "desc": "说明描述",
                "status": "1",
                "sales": "",
                "created_at": "",
                "updated_at": "",
                "type": "",
                "status_text": "",
                "full_image": "",
                "gifts": [
                    {
                        "id": "",
                        "recharge_card_id": "",
                        "type": "",
                        "ext": {
                            "entity": [
                                {
                                    "num": "",
                                    "id": ""
                                }
                            ]
                        },
                        "created_at": "",
                        "updated_at": "",
                        "type_name": ""
                    }
                ]
            }
        ]
    }
}

异常示例

{
    "status": true,
    "code": "异常编码，根据不同的业务返回编码",
    "message": "异常说明：查询的信息不存在"
}

错误码

{
    "status": false,
    "code": "系统错误编码：详见全局返回编码",
    "message": "系统错误说明"
}

请求地址

请求方式 版本信息 请求地址
POST V2 http://openapi.zvcms.com/api/v2

公共参数

参数 参数类型 是否必填 默认值 描述
OpenId string 是 密钥Id
GrantCode string 是 授权code
Token string 是 签名，参考《数字签名sign》
Timestamp string 是 当前时间戳
Nonce string 是 随机正整数
Action string 是 communal.user.rule-lists 接口方法
Params array 是 业务参数

请求参数

参数 参数类型 是否必填 默认值 描述
page int 否 1 当前页数
page_size int 否 10 当前页面记录数

响应参数

参数 参数类型 描述
status bool 成功或失败
code int 成功/错误编码
message string 成功/错误描述
data array
 ├current_page int 当前页数
 ├per_page int 每页显示数
 ├last_page int 最后一页
 ├total int 总页数
 ├cy_list array
  ├0 array
   ├id int 规则id
   ├name string 规则name
   ├image string 默认图片
   ├value Money(元) 储值卡金额
   ├sell_price Money(元) 销售价格
   ├desc string 说明描述
   ├status int 状态，0：弃用，1：启用
   ├sales int 销量
   ├created_at TimeStamp 创建时间
   ├updated_at TimeStamp 修改时间
   ├type string 0代表的是商家 1代表的是平台
   ├status_text string 状态描述
   ├full_image string 图片绝对路径
   ├gifts array
    ├0 array
     ├id int 礼品id
     ├recharge_card_id Int 主体id，recharge_cards表id
     ├type int 活动类型，Balance：赠送余额，Coupon：优惠券，Card：会员卡，Points：赠送积分
     ├ext array
      ├entity array
       ├0 array
        ├num int 数量1
        ├id Int 表示赠送余额20（或优惠券id为20） 跟type强关联
     ├created_at TimeStamp 创建时间
     ├updated_at TimeStamp 修改时间
     ├type_name string 类型名称

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "communal.user.rule-lists",
    "Params": {
        "page": "",
        "page_size": ""
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "current_page": "1",
        "per_page": "10",
        "last_page": "20",
        "total": "20",
        "cy_list": [
            {
                "id": "1",
                "name": "规则name",
                "image": "\/s1000106\/2018\/07\/09\/cfbc38cae535a8ad8a.jpeg",
                "value": "2",
                "sell_price": "2",
                "desc": "说明描述",
                "status": "1",
                "sales": "",
                "created_at": "",
                "updated_at": "",
                "type": "",
                "status_text": "",
                "full_image": "",
                "gifts": [
                    {
                        "id": "",
                        "recharge_card_id": "",
                        "type": "",
                        "ext": {
                            "entity": [
                                {
                                    "num": "",
                                    "id": ""
                                }
                            ]
                        },
                        "created_at": "",
                        "updated_at": "",
                        "type_name": ""
                    }
                ]
            }
        ]
    }
}

异常示例

{
    "status": true,
    "code": "异常编码，根据不同的业务返回编码",
    "message": "异常说明：查询的信息不存在"
}

错误码

{
    "status": false,
    "code": "系统错误编码：详见全局返回编码",
    "message": "系统错误说明"
}

免费升级

营销功能、插件持续每月更新开发升级

免费专业培训

每月建站、微信营销、电商等互联网增值培训

7×24小时服务支持

400电话、QQ、微信、在线等多渠道售后支持

 

安徽智迈科技股份有限公司 版权所有 Copyright 2009-2018 皖公网安备 34019202000074号 增值电信业务经营许可证：皖B2-20170075