Skip to main content

【转赠】领取

基本信息

接口名称:领取状  态:已完成
接口路径:POST /paas/micro/voucherwallet/receiveTransfer更新时间:2023-06-25 22:25:10
Mock地址:https://apimock.e-buychina.com/mock/77/paas/micro/voucherwallet/receiveTransfer

请求参数

Headers:

参数名称参数值是否必填
Content-Typeapplication/json是

Body:

参数名称类型必填默认值备注其他信息
uuidstring是请求序列号,请求的唯一标识,不可重复,格式:8位日期格式-32位随机小写字母或数字,示例:20210602-offmplixuwhggrgezfnuivexeabdvbue最大长度:50
最小长度:1
Mock:@now('yyyyMMdd')-@string('lower',32)
appIdstring是请求AppId最大长度:50
最小长度:1
Mock:@natural
actionstring是交易类型最大长度:50
最小长度:1
Mock:receiveTransfer
timestampnumber是请求时间戳Mock:@timestamp
signTypestring是签名类型最大长度:20
最小长度:1
Mock:sha256
signstring是签名值最大长度:500
最小长度:1
Mock:@natural
langstring是语言最大长度:50
最小长度:1
Mock:zh_CN
contentobject是请求报文
  memberIdstring否领取人的会员ID(memberId,thirdOpenId不可同时为空,优先使用memberId)最大长度:32
Mock:@string
  thirdOpenIdstring否领取人的三方用户id(memberId,thirdOpenId不可同时为空,优先使用memberId)最大长度:64
Mock:@string
  packageIdstring是包裹id最大长度:32
最小长度:1
Mock:@string
  phoneNumberstring是领取人的手机号最大长度:11
最小长度:11
Mock:@integer

返回数据

参数名称类型必填默认值备注其他信息
uuidstring是请求序列号最大长度:50
最小长度:1
Mock:@now('yyyyMMdd')-@string('lower',32)
successboolean是交易成功与否Mock:@boolean
actionstring是交易类型最大长度:50
最小长度:1
Mock:receiveTransfer
timestampnumber是返回时间戳Mock:@timestamp
errorCodestring是错误码最大长度:50
Mock:@word
errorMessagestring是错误描述最大长度:50
Mock:@csentence
signTypestring否签名类型最大长度:20
Mock:sha256
signstring否签名值最大长度:500
Mock:@natural
contentobject是返回报文
  senderMemberIdstring否转增者会员id最大长度:32
Mock:@string
  senderThirdOpenIdstring否转增者三方用户id最大长度:64
Mock:@string
  voucherListarray是领取的卡券码

备注

注意:为保证签名的一致性,返回报文中的content字段将以string形式的进行返回,例如:

{
	"content": {
		"userId": 1,
		"userName": "Trump"
	}
}

将返回为:

{
	"content": "{\"userId\":1,\"userName\":\"Trump\"}"
}

变更历史

变更日期变更内容
2022-04-30
2022-04-19
2022-04-19
api-id=35454