文档
测试

sendwb / 发币

GET
https://walle.app/wxapp/api/sendwb

接口描述

wb直接发币 或 wb_wait创建合约的待确认币(待确认币通过sendwb_wait接口二次确认后再发币)。(大陆网络可替换walle.app为km-app.cn)

1.1 请求参数

参数名
类型
描述
必填
uid
字符串
钱包UID地址
必填
order
字符串
商品订单号(5-32位,唯一不可重复)
必填
order_time
数字
10位时间戳,订单创建日期(例如:1594202995)
必填
tname
字符串
商品名称x数量(分隔符为--"减号",不超过256位)例如:1996单瓶装x3--五粮春50度整箱装x1
必填
wb
浮点
发币数量(直接创建区块标识并发币,数值可精确到小数点后3位)
必填
wb_wait
浮点
待确认币数量(创建合约,通过sendwb_wait接口二次确认合约后发币,数值可精确到小数点后3位)
必填
appkey
字符串
渠道钥匙(非公开)
必填
skey
字符串
密钥签名(见下方)
必填

skey / 密钥签名

skey参数为:按以下顺序,参数==字符串组合==的==md5==加密 MD5例子: ==md5("==`uid=???&order=???&order_time=???&tname=???&wb=???&wb_wait=???&secret=???`==")== - &==secret===??? (md5加密前的secret参数为appkey对应密钥,非公开) MD5结果为: `18c48ff3ff4f07cf2c79d1a35e940384`(小写32位) 最终url请求地址: https://walle.app/wxapp/api/sendwb?uid=???&order=???&order_time=???&tname=???&wb=???&wb_wait=???==&appkey=???&skey=18c48ff3ff4f07cf2c79d1a35e940384== - appkey不包含在md5签名中,但url请求为必须 - skey为md5签名值,url请求为必须 - md5签名中,==wb==和==wb_wait==不能为空,无值则填0(例如&wb_wait=0)

1.2 响应参数

参数名
类型
描述
必填
status
数字
状态:1成功(建议判断数字类型为1即成功,其他均为失败)
必填
errid
字符串
错误ID
可选
errmsg
字符串
errid存在:额外错误说明
可选
bid
字符串
重要:区块标识(如果是wb_wait待确认合约币,需通过审核接口完成合约补发币)
必填
bid_time
日期
区块交易/合约创建时间
必填
wb_time
日期
区块发币时间(为0则未发币)
必填
data
对象
返回数据(见1.3)
必填

1.3 返回data(账户/区块信息)

参数名
类型
描述
必填
uid
字符串
账户UID
可选
phone
字符串
账户手机号
可选
wb
小数
用户钱包:W币余额总数(小数点后3位)
必填
_wb
小数
本次交易:W币数量(小数点后3位)
必填
wb_wait
小数
用户钱包:W币待确认总数(小数点后3位)
必填
_wb_wait
小数
本次交易:待确认W币数量(小数点后3位)
必填
createdAt
日期
账户创建时间
可选
channel
字符串
渠道(无:钱包原有用户 api:通过api创建的用户)
可选
appkey
字符串
区块标识已存在:创建该区块的appkey
必填
order
字符串
区块标识已存在:订单号
必填
order_time
日期
区块标识已存在:订单时间
必填
tname
字符串
区块标识已存在:订单/商品名称
必填

1.4 错误代码

参数名
类型
描述
必填
998
非法传递 secret (secret仅能存在签名中,请勿泄露)
可选
999
appkey错误(联系获取指定正确的appkey)
可选
1000
参数丢失:缺少uid
可选
1001
uid格式错误
可选
1002
参数丢失:缺少order
可选
1003
order格式错误:含有特殊字符,小于5、大于64
可选
1004
参数丢失:缺少order_time
可选
1005
order_time格式错误:10位时间戳
可选
1006
参数丢失:缺少tname
可选
1007
tname格式错误:含有特殊字符,小于2位大于256位
可选
1008
wb、wb_wait不能同时为空
可选
1009
wb、wb_wait不能同时有值
可选
1010
wb、wb_wait参数不正确
可选
1011
参数丢失:缺少skey
可选
1012
skey格式错误:含有特殊字符、必须为32位md5值
可选
1013
skey签名错误:详见1.1下方 skey / 密钥签名
可选
1100,1201,1301,1401
服务繁忙或异常(无法连接到网络节点,请稍后重试)
可选
1101
钱包账户不存在、UID错误
可选
1202
appkey对应的order已成功创建区块标识
可选