请求地址: /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;
/**
* 券编号
*/
private List<String> couponNos;
}