优惠券兑换

请求地址: /v2/common/applyExchange

服务协议: HTTP/POST

请求参数:

参数名称 类型 必选 说明
client_id string Y 申请的client_id
timestamp long Y 时间戳(如果超过当前时间2分钟就返回408)
sign string Y 签名(参考文档1.3签名认证)
cityCode String Y 用于下单所在城市编码,无法获取到传0000
phone String N 用户手机号(与用户编号两者必有其一)
userNo Long N 用户编号
skuNo String Y 属性编码
spuNo String Y 商品编码
companyOrderNo String Y 接入方订单号(接入方保证唯一)
num Integer N 兑换份数,默认为1,最多30
longitude Double N 经度
latitude Double N 纬度

响应data参数:

参数名 类型 必有 说明
code integer Y 返回code,0为成功,340012:同一用户兑换超出限制
message string Y 错误信息
data List Y 返回数据

结果示例:

@Data
public class ExchangeResDTO {

    /**
     * 用户编号
     */
    private Long userNo;

    /**
     * 手机号
     */
    private String phone;

    /**
     * 兑换生成的订单编号
     */
    private String orderNo;

    /**
     * 时间戳
     */
    private Long timestamp;

    /**
     * 兑换编码
     */
    private List<String> exchangeNo;
}