请求地址: /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;
}