开发指南
API
官网
API 3.0
API 3.0 > 7.1 兑换码操作 > 7.1.4 根据商品编码获取兑换码

7.1.4 根据商品编码获取兑换码

开启令牌和权限后可调用。签名方式请查看开发指南
场景描述： 根据第三方业务编码，商品规格码，获取兑换码 【一个商品编码可换取多个兑换码】购买电子兑换码
零售 餐饮

请求地址

请求方式 版本信息 请求地址
POST V3 http://openapi.zvcms.com/v3/coupon/exchange/buyExchangeCode

公共参数

参数 参数类型 是否必填 默认值 描述
openId string 是 密钥Id
grantCode string 是 授权code
token string 是 签名，参考《数字签名sign》
timestamp string 是 当前时间戳
nonce string 是 随机正整数
params array 是 业务参数

请求参数

参数 参数类型 是否必填 默认值 描述
customerId int 否 用户id
bizId string 是 业务标识，唯一性
count string 是 购买数量
thirdBizCode string 否 第三方业务编码-有赞商品规格编码 thirdBizCode和activityCode二选一必填，同时填写时优先判断activityCode
activityCode string 否 活动标识，（兑换活动中的的活动id） thirdBizCode和activityCode二选一必填，同时填写时优先判断activityCode

响应参数

参数 参数类型 描述
Code array 兑换码 ["12423432","21432432"]
activityName string 兑换活动名称

请求示例

{
    "openId": "6dc05b4ac175cf316d226252b05cf685",
    "grantCode": "782c281f62",
    "timestamp": "1547186244",
    "nonce": "658965",
    "token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "params": {
        "customerId": "23123",
        "bizId": "appley2132131",
        "count": "3",
        "thirdBizCode": "",
        "activityCode": ""
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "Code": "[\"12423432\",\"21432432\"]",
        "activityName": "有赞测试兑换码"
    }
}

异常示例

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

错误码

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

请求地址

请求方式 版本信息 请求地址
POST V3 http://openapi.zvcms.com/v3/coupon/exchange/buyExchangeCode

公共参数

参数 参数类型 是否必填 默认值 描述
openId string 是 密钥Id
grantCode string 是 授权code
token string 是 签名，参考《数字签名sign》
timestamp string 是 当前时间戳
nonce string 是 随机正整数
params array 是 业务参数

请求参数

参数 参数类型 是否必填 默认值 描述
customerId int 否 用户id
bizId string 是 业务标识，唯一性
count string 是 购买数量
thirdBizCode string 否 第三方业务编码-有赞商品规格编码 thirdBizCode和activityCode二选一必填，同时填写时优先判断activityCode
activityCode string 否 活动标识，（兑换活动中的的活动id） thirdBizCode和activityCode二选一必填，同时填写时优先判断activityCode

响应参数

参数 参数类型 描述
Code array 兑换码 ["12423432","21432432"]
activityName string 兑换活动名称

请求示例

{
    "openId": "6dc05b4ac175cf316d226252b05cf685",
    "grantCode": "782c281f62",
    "timestamp": "1547186244",
    "nonce": "658965",
    "token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "params": {
        "customerId": "23123",
        "bizId": "appley2132131",
        "count": "3",
        "thirdBizCode": "",
        "activityCode": ""
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "Code": "[\"12423432\",\"21432432\"]",
        "activityName": "有赞测试兑换码"
    }
}

异常示例

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

错误码

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

免费升级

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

免费专业培训

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

7×24小时服务支持

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

 

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