获取用户地址
#简要描述: 获取用户地址(如果不存在则创建)。
- 请求方式: POST
- 请求接口: https://网关域名/wallet-trade-merchant/merchant/user/get-address
- 请求媒体类型( JSON 数据格式 )Content-Type: application/json
查询参数
参数名称 | 类型 | 必填 | 参数含义 | 参数说明 |
---|---|---|---|---|
merchantId | int64 | 是 | 商户 ID | |
userId | int64 | 是 | 用户 ID | 商户本地用户唯一 ID |
network | string | 是 | 主网 | TRON(可通过获取一个币种支持的全部主网 api 查询) |
key | string | 是 | 商户 key | 平台分配商户 key |
secret | string | 是 | 商户 secret | 平台分配商户 secret |
sign | string | 是 | 签名参照(如何签名) | 详见如何签名规则 |
请求 json 样例
{
"merchantId": "302992856974",
"userId": 77,
"network": "TRON",
"key": "9yUreYgTRtit39Dy",
"secret": "D2PQPllGEBOV4mcMxoKTM7foVpzqrjIx",
"sign": "3876e3b40ce4938c3123f07cd5aecb8c"
}
返回值
参数名称 | 类型 | 参数含义 | 参数说明 |
---|---|---|---|
code | int32 | 请求状态 | 返回代码,0 为业务成功,否则代表不同的错误 |
success | boolean | 成功状态 | 成功标识,与 code=0 一致,用于兼容历史 |
message | string | 描述 | 错误消息。如果有错误时,返回的错误消息 |
data | json | 返回数据。 | 参数详见下面说明 |
返回示例
{
"code": 0,
"success": true,
"message": null,
"data": {
"address": "TDt7K2TLZ6hvJrAdkSfHtEkTnadEFBFqAy",
"merchantId": 302992856974,
"network": {
"name": "TRON",
"queryBaseUrl": "https://nile.tronscan.org/",
"coinTotal": 2,
"collectionNetworkConfirm": 1,
"masterCoin": "TRX",
"withdrawalNetworkConfirm": 1
},
"userId": 77
}
}
data 参数说明
参数名称 | 类型 | 参数含义 | 备注 |
---|---|---|---|
merchantId | int64 | 商户 ID | |
userId | int64 | 用户 ID | |
address | string | 链地址 | |
network | object | 链信息 | |
└ name | string | 主网名称 | |
└ queryBaseUrl | string | 链上查询网址 | |
└ collectionNetworkConfirm | int64 | 充值网络确认次数 | |
└ withdrawalNetworkConfirm | int64 | 出款网络确认次数 | |
└ coinTotal | int64 | 币数量 | |
└ masterCoin | string | 主链币种 |