简要描述:

请求域名:

  • http://xx.com

请求路由:

POST/&route=plugin.yz-supply-under-sink-machine.frontend.privilege.privilege.index

请求参数说明:

参数名 类型 是否必需 说明
page int 分页
pageSize int 分页
device_id int 设备id

返回示例:

正确时返回:

{
    "result": 1, // 响应状态码:1表示成功,0表示失败
    "msg": "成功", // 响应消息,描述操作结果
    "data": { // 响应数据主体
        "list": [ // 数据列表,包含权益有效期记录
            {
                "id": 8, // 记录ID,唯一标识
                "uniacid": 2, // 公众号ID,标识不同的店铺环境
                "order_no": null, // 订单号,此处为空(可能不是通过购买获得)
                "member_id": 1, // 机主会员ID,权益所属的会员
                "device_sn": null, // 设备SN码,此处为空(可能仅使用IMEI标识)
                "device_imei": "321312321312", // 设备IMEI码,设备唯一标识
                "get_way": 3, // 获取方式:3表示会员受赠(对应下方的get_type_text)
                "obtain_amount": 1000, // 获得水量,单位:升
                "remaining_amount": 0, // 剩余可用水量,单位:升,当前为0
                "used_amount": 0, // 已使用水量,单位:升,当前为0
                "expire_time": 1762426189, // 使用截止时间,UNIX时间戳
                "recharge_time": 10, // 充值天数,权益有效期10天
                "remark": "从会员ID:1 受赠", // 备注信息,记录操作说明
                "third_id": 6, // 第三方记录ID,关联中台记录
                "created_at": "2025-11-10 13:42:42", // 创建时间,格式化时间
                "updated_at": "2025-11-07 14:25:27", // 更新时间,格式化时间
                "deleted_at": null, // 删除时间,软删除标记,此处为空(未删除)
                "get_type_text": "会员受赠", // 获取方式文本描述,对应get_way=3
                "remaining_water": 0, // 剩余水量,可能是展示字段,与remaining_amount相同
                "privilege_water": 1000, // 权益水量,可能是展示字段,与obtain_amount相同
                "used_water": 0, // 已用水量,可能是展示字段,与used_amount相同
                "expired_at": "2025-11-06 18:49:49" // 过期时间,格式化时间,对应expire_time
            }
        ],
        "total": 3, // 总记录数,表示符合条件的记录共有3条
        "page": "1", // 当前页码,字符串类型
        "pageSize": "1" // 每页记录数,字符串类型,此处每页显示1条
    }
}

返回参数说明:

参数名 类型 说明