对外API
系统接口
用户接口：

• 用户登录类

  • 用户登录
  • 忘记密码

• 用户注册类

  • 请求获取验证码
  • 校验验证码
  • 设置密码

• 首页

• 首页-抢码应用类

• 首页-资产导入

• 首页-绑定挖矿码(此挖矿码为S开头的,是活动赠送,绑定)

• 首页-抢码应用

• 绑定ETH

• 预约抢码

• 钱包

• 我的

API

version 1.0

用户登录

用于用户登录，手机号码作为账号，并输入密码。
数据格式：json

请求：

• url： https://ip:port/login
• 请求方式: POST
• 参数类型：

参数	类型	必须	说明
phoneNumber	string	是	手机号码为用户的登录账号
password	string	是	登录密码应为MD5加密后的密文
areacode	string	是	地区码，如中国为86

• 参数例子：

{
  "phoneNumber":"××××××" ,
  "password":"××××××"
  "areacode":"××××××"
}

返回：

• 参数类型：

参数	类型	必须	说明
code	int	是	代表当前请求的反馈结果，详解后文returecode
token	string	是
phoneNumber	string	是	手机号码为用户的登录账号
userid	int	是	用户的id
imgurl	string	是	用户请求头像的地址
areacode	string
ethaddress	string	是	用户的eth地址
message	string	否	一些文本说明，可有可无

• 成功：

{
  "code" : 0 ,
  "message":"success",
  "data":{
      "token":"××××××",
      "phonenumber":"××××××",
      "userid":——，
      "imgurl":"××××××"
      "areacode":"××××××",
      "ethaddress":"××××××",
    }
 } 

• 失败：

{
  "code" : 302 ,
  "message":"failed",
  "data":{
      "token":null
    }
 } 

校验版本

校验版本

请求：

• url： https://ip:port/checkUpdate

返回：

• 参数类型：

参数	类型	必须	说明
code	int	是	代表当前请求的反馈结果，详解后文returecode
message	string	否	一些文本说明，可有可无
versionName	string	是	用以在APP上显示版本号
versionCode	int	是	真正用来校验APK版本的
apkurl	string	是	APK的下载链接

|changelog|||

• 成功：

{
  "code" : 0 ,
  "message":"success",
  "data":{
      "versionCode":_______,
      "versionName":"××××××",
      "url":"××××××",
       "changelog":"××××××"
    }
 } 

token过期

当检测到token过期时，会返回一个状态吗，并要求重新登录
数据格式：json

请求：

• url： https://ip:port/login
• 请求方式: POST
• 参数类型：

返回：

• 参数类型：

参数	类型	必须	说明
code	int	是	代表当前请求的反馈结果，详解后文returecode
token	string	是
phoneNumber	string	是	手机号码为用户的登录账号
userid	int	是	用户的id
message	string	否	一些文本说明，可有可无

{
  "code" : 303 ,
  "message":"token timeout",
  "data":null
 } 

用户注册 ——请求获取验证码

该API用于向服务器请求一个短信验证码，故只需要正确的手机号码即可。
数据格式：json

请求：

• url: https://192.168.1.1:9090/register/getCheckCode

• 请求方式: POST/FORM

• 参数类型

参数	类型	必须	说明
areaCode	string	是	用户的国家区码，如中国大陆的区码为86
phoneNumber	string	是	待获取验证码的手机号码

• 参数例子

{
 "phoneNumber":"××××××"，
 "areaCode":"××××××"
}

返回：

-参数类型：

参数	类型	必须	说明
code	int	是	代表当前请求的反馈结果，详解后文returecode
message	string	否	一些文本说明，可有可无

• 成功：

{
  "code" : 0 ,
  "message":"send success",
  "data":null
 } 

• 失败：

{
  "code" : 315 ,
  "message":"the phone-number is not exit",
  "data":null
 } 

用户注册 ——注册

输入之前已请求过的验证码，交给后端进行匹配

请求：

• url: https://ip:port/register/regist

• 请求方式: POST/FORM

• 数据格式：json

• 参数类型

参数	类型	必须	说明
phoneNumber	string	是	待获取验证码的手机号码
areaCode	string	是	用户的国家区码，如中国大陆的区码为86
checkCode	string	是	验证码
password	string	是	待设置的密码
username	string	是	待注册的用户名

• 参数例子

{
 "phoneNumber":"××××××"，
 "checkCode":"××××××"
  "areacode":"××××××",
 "password":"××××××"
 "username":"××××××"
}

返回：

• 参数类型：

参数	类型	必须	说明
code	int	是	代表当前请求的反馈结果，详解后文returecode
message	string	否	一些文本说明，可有可无

• 成功：

{
  "code" : 0 ,
  "message":"regist success",
  "data":null
 } 

• 失败：

{
  "code" : 413 ,
  "message":"regist failed",
  "data":null
 } 

忘记密码 ——请求获取验证码

该API用于向服务器请求一个短信验证码，故只需要正确的手机号码即可。
数据格式：json

请求：

• url: https://ip:port/register/getCheckCode

• 请求方式: POST/FORM

• 参数类型

参数	类型	必须	说明
areaCode	string	是	用户的国家区码，如中国大陆的区码为86
phoneNumber	string	是	待获取验证码的手机号码

• 参数例子

{
 "phoneNumber":"××××××"，
 "areaCode":"××××××"
}

返回：

-参数类型：

参数	类型	必须	说明
code	int	是	代表当前请求的反馈结果，详解后文returecode
message	string	否	一些文本说明，可有可无

• 成功：

{
  "code" : 0 ,
  "message":"send success",
  "data":null
 } 

• 失败：

{
  "code" : 315 ,
  "message":"the phone-number is not exit",
  "data":null
 } 

忘记密码 ——重设密码

输入之前已请求过的验证码，以及待设置的密码,交给后端.

请求：

• url: https://192.168.1.1:9090/register/ResetPassword
• 请求方式: POST/FORM
• 数据格式：json
• 参数类型

参数	类型	必须	说明
phoneNumber	string	是	待获取验证码的手机号码
password	string	是	待设置的密码
checkcode	string	是	验证码
areaCode	string	是	用户的国家区码，如中国大陆的区码为86

• 参数例子

{
 "phoneNumber":"××××××"，
 "checkcode":"××××××"，
 "password":"××××××"
 "areacode":"××××××"
}

返回：

• 参数类型：

参数	类型	必须	说明
code	int	是	代表当前请求的反馈结果，详解后文returecode
message	string	否	一些文本说明，可有可无

• 成功：

{
  "code" : 0 ,
  "message":"reset success",
  "data":null
 } 

• 失败：

{
  "code" : 414,
  "message":"reset failed",
  "data":null
 } 

首页

请求：

• url: https://192.168.1.1:9090/index
• 请求方式: POST
• 数据格式：json
• 参数类型

参数	类型	必须	说明
token	string	是

• 参数例子

{
 "phoneNumber":"××××××" ,
 "token":"××××××"，
}

返回:

• 参数类型：

参数	类型	必须	说明
code	int	是	代表当前请求的反馈结果，详解后文returecode
totalIncom	string	是	总的挖矿收益（totalIncom中第一个l是“小写的L”， 第二个I是“大写的i”）(需要前端string—>float64)
yestodayIncom	string	是	昨日的挖矿收益(需要前端string—>float64)
currentPrice	string	是	当前BCDN币的价格(需要前端string—>float64)
name	string	是	name用来区分广告图片,如果本地已有该图片name,就不必再向服务器下载图片
imgurl	string	是	下载图片的链接
message	string	否	一些文本说明，可有可无

{
  "code" : 0 ,
  "message":"index",
  "data":{
        "totalIncom": "××××××",
        "yestodayIncom" : "××××××",
        "currentPrice":"××××××",
        "totalValue":"××××××",
        "advertising":[
            {"name":"××××××", "imgurl":"××××××"},//当name为default的时候，就播放本地的默认广告位招商图片
            {"name":"××××××", "imgurl":"××××××"},
            {"name":"××××××", "imgurl":"××××××"},

        ]
    }
 } 

首页-资产导入查询

请求：

• url: https://192.168.1.1:9090/app/importFromWeb
• 请求方式: POST
• 数据格式：json
• 参数类型

参数	类型	必须	说明
mailReceiver	string	是		官网邮箱
webPassword	string	是		官网密码 md+salt
checkCode	string	是		邮件验证码
uid	string	是		用户userid

• 参数例子

{
 "mailReceiver":"××××××" ,
 "webPassword":"××××××"，
 "checkCode":"××××××"，
 "uid":"××××××"，
}

返回:

• 参数类型：

参数	类型	必须	说明
RetCode	int	是	代表当前请求的反馈结果，详解后文returecode
Description	string	是
Err	string	是
data	string	是

{
  "RetCode" : 0 ,
  "Description ":"",
  "Err ":"",
  "data":{
         Btc: 0.0,
         Eth: 0.0,
         Bcdn: 0.0
    }
 } 

首页-资产导入提交

请求：

• url: https://192.168.1.1:9090/app/importFromWeb/importConfirm
• 请求方式: POST
• 数据格式：json
• 参数类型

参数	类型	必须	说明
mailReceiver	string	是		官网邮箱
webPassword	string	是		官网密码 md+salt
uid	string	是		用户userid

• 参数例子

{
 "mailReceiver":"××××××" ,
 "webPassword":"××××××"，
 "uid":"××××××"
}

返回:

• 参数类型：

参数	类型	必须	说明
RetCode	int	是	代表当前请求的反馈结果，详解后文returecode
Description	string	是
Err	string	是
data	string	是

{
  "RetCode" : 0 ,
  "Description ":"",
  "Err ":"",
  "data":{
    }
 } 

首页-内测挖矿收益导入查询

请求：

• url: https://192.168.1.1:9090/app/importFromMinner
• 请求方式: POST
• 数据格式：json
• 参数类型

参数	类型	必须	说明
ethAddress	string	是	ETH地址
invitedCode	string	是	内测试码
uid	string	是	用户userid

• 参数例子

{
 "mailReceiver":"××××××" ,
 "webPassword":"××××××"，
 "uid":"××××××"，
}

返回:

• 参数类型：

参数	类型	必须	说明
RetCode	int	是	代表当前请求的反馈结果，详解后文returecode
Description	string	是
Err	string	是
data	string	是

{
  "RetCode" : 0 ,
  "Description ":"",
  "Err ":"",
  "data":{
         Btc: 0.0,
         Eth: 0.0,
         Bcdn: 0.0
    }
 } 

首页-内测挖矿收益导入提交

请求：

• url: https://192.168.1.1:9090/app/importFromMinner/importConfirm
• 请求方式: POST
• 数据格式：json
• 参数类型

参数	类型	必须	说明
ethAddress	string	是	ETH地址
invitedCode	string	是	内测试码
uid	string	是	用户userid

• 参数例子

{
 "mailReceiver":"××××××" ,
 "webPassword":"××××××"，
 "uid":"××××××"，
}

返回:

• 参数类型：

参数	类型	必须	说明
RetCode	int	是	代表当前请求的反馈结果，详解后文returecode
Description	string	是
Err	string	是
data	string	是

{
  "RetCode" : 0 ,
  "Description ":"",
  "Err ":"",
  "data":{
    }
 } 

获得邮箱验证码

请求：

• url: https://192.168.1.1:9090/app/public/genMailCheckCode
• 请求方式: POST
• 数据格式：json
• 参数类型

参数	类型	必须	说明
mailReceiver	string	是	邮箱

• 参数例子

{
 "mailReceiver":"××××××" 
}

返回:

• 参数类型：

参数	类型	必须	说明
RetCode	int	是	代表当前请求的反馈结果，详解后文returecode
Description	string	是
Err	string	是
data	string	是

{
  "RetCode" : 0 ,
  "Description ":"",
  "Err ":"",
  "data":{
    }
 } 

首页——预约抢码应用

请求：

• url: https://192.168.1.1:9090/index/reservationCode
• 请求方式: POST
• 数据格式：json
• 参数类型

参数	类型	必须	说明
phoneNumber	string	是	手机号码
token	string	是

• 参数例子

{
 "phoneNumber":"××××××" ,
 "token":"××××××"，
}

返回:

参数	类型	必须	说明
code	int	是	代表当前请求的反馈结果，详解后文returecode
ethAddress	string	视返回的code决定	用户的以太坊地址
reservationCode	string	视返回的code决定	用户的预约码
timestamp	int64	是	开奖的时间戳
time	string	是	中奖时间
nickname	string	是	中奖的用户名
timesofperson	string	是	预约的人数
type	int	是	type
message	string	否	一些文本说明，可有可无
list
message	string	否	一些文本说明，可有可无

• 成功1：（说明还没有绑定ETH地址，需要进入绑定界面 ）

{
  "code" : 0 ,
  "message":"no ethAddress",
  "data":{
    "type": 1,
    "timestamp": ______，
    "timesofperson":"××××××"
  }
 } 

• 成功2：（已经绑定ETH地址，但还没有参与抢码活动）

{
  "code" : 0 ,
  "message":"reservationCode",
  "data":{
      "type" :2,
      "ethAddress":"××××××"
      "timestamp": ______
    }
 } 

• 成功3-1：（还未开奖，只显示预约码）

{
  "code" : 0 ,
  "message":"not time",
  "data":{
      "type" :3,
      "reservationCode":"××××××,
      "timestamp": ______
    }
 } 

• 成功3-2 ：（已开奖，但未中奖）

{
  "code" : 0 ,
  "message":"make persistent efforts",
  "data":{
      "type" :4,
      "reservationCode":"××××××",
        "timestamp": ______ ,
        "list":[
        {time:"××××××",nickname:"××××××"},
        {time:"××××××",nickname:"××××××"},
        {time:"××××××",nickname:"××××××"},
        {time:"××××××",nickname:"××××××"},
        {time:"××××××",nickname:"××××××"},
        {time:"××××××",nickname:"××××××"},    
    ],
    }
 } 

• 成功3-3 ：（已开奖，且中奖）

{
  "code" : 0 ,
  "message":"Congratulations",
  "data":{
       "type" :5,
      "reservationCode":"××××××",
      "list":[
        {time:"××××××",nickname:"××××××"},
        {time:"××××××",nickname:"××××××"},
        {time:"××××××",nickname:"××××××"},
        {time:"××××××",nickname:"××××××"},
        {time:"××××××",nickname:"××××××"},
        {time:"××××××",nickname:"××××××"},    
    ],
        "timestamp": ______
    }
 } 

首页 ——预约抢码应用——绑定ETH——使用以太坊地址

请求：

url： https://ip:port/index/reservationCode/bindethaddr/forEth

• 请求方式: POST
• 数据格式：json
• 参数类型

参数	类型	必须	说明
phoneNumber	string	是	手机号码
token	string	是	token
ethAddress	string	是	用户想要参与抢码，就必须绑定一个eth地址，且地址中必须拥有1000以上的BCDN
type	string	是	如果是抢码，则type为"checkCoin",如果是非抢码的绑定ETH地址，则type为"normal"

• 参数例子

{
 "phoneNumber":"××××××"，
 "token":"××××××"，
 "ethAddress":"××××××"
  "type":"******"
}

返回:

参数	类型	必须	说明
code	int	是	代表当前请求的反馈结果，详解后文returecode
ethAddress	string	视返回的code决定	用户的以太坊地址
coins	string	视返回的code决定	刚刚预提交的eth账户中BCDN的数量
message	string	否	一些文本说明，可有可无

• 成功：（已经绑定ETH地址成功）

{
  "code" : 0 ,
  "message":"success",
  "data":{
      "ethAddress":"××××××"
    }
 } 

• 失败1：（以太坊地址正确，带没有足够的以太币，还得重新输入）该错误类型只有在抢码绑定时出现

{
  "code" : 2000 ,
  "message":"sorry，you don`t have enough coins",
  "data":{
      "coins":"××××××
    }
 } 

• 失败2：（以太坊地址绑定失败，错误的地址或者该地址已经被人绑定）

{
  "code" : 2002 ,
  "message":"the wrong ethAddress",
  "data":null
 } 

首页 ——预约抢码应用——绑定ETH——使用gateio

请求：

url： https://ip:port/index/reservationCode/bindethaddr/forGateio

• 请求方式: POST
• 数据格式：json
• 参数类型

参数	类型	必须	说明
phoneNumber	string	是	手机号码
token	string	是	token
ethAddress	string	是	用户想要参与抢码，就必须绑定一个eth地址，且地址中必须拥有1000以上的BCDN

• 参数例子

{
 "phoneNumber":"××××××"，
 "token":"××××××"，
 "ethAddress":"××××××"
}

返回:

参数	类型	必须	说明
code	int	是	代表当前请求的反馈结果，详解后文returecode
ethAddress	string	视返回的code决定	用户的以太坊地址
coins	string	视返回的code决定	刚刚预提交的eth账户中BCDN的数量
message	string	否	一些文本说明，可有可无

• 成功：（已经绑定ETH地址成功）

{
  "code" : 0 ,
  "message":"success",
  "data":{
      "ethAddress":"××××××"
    }
 } 

• 失败1：（以太坊地址正确，带没有足够的以太币，还得重新输入）该错误类型只有在抢码绑定时出现

{
  "code" : 2000 ,
  "message":"sorry，you don`t have enough coins",
  "data":{
      "coins":"××××××
    }
 } 

• 失败2：（以太坊地址绑定失败，错误的地址或者该地址已经被人绑定）

{
  "code" : 2002 ,
  "message":"the wrong ethAddress",
  "data":null
 } 

首页 ——预约抢码应用——预约抢码

请求：

• url: https://ip:port/index/reservationCode/getCode
• 请求方式: POST
• 数据格式：json
• 参数类型

参数	类型	必须	说明
phoneNumber	string	是	手机号码
token	string	是	token

• 参数例子

{
 "phoneNumber":"××××××"，
 "token":"××××××"
}

返回:

参数	类型	必须	说明
code	int	是	代表当前请求的反馈结果，详解后文returecode
ethAddress	string	视返回的code决定	用户的以太坊地址
coins	string	视返回的code决定	刚刚预提交的eth账户中BCDN的数量

• 成功：（已经成功预约，等待开奖）？

{
  "code" : 0 ,
  "message":"success",
  "data":{
      "reservationCode":"××××××
    }
 } 

首页 ——绑定额外挖矿码应用

请求：

• url: https://ip:port/index/bindExtraMinnerCode
• 请求方式: POST
• 数据格式：json
• 参数类型

参数	类型	必须	说明
phoneNumber	string	是	手机号码
token	string	是	token
code	string	是	待绑定的挖矿码RSA加密

• 参数例子

{
 "phoneNumber":"××××××"，
 "token":"××××××"
 "code”:"××××××"

}

返回：

成功

{
  "code" : 0,
  "message":"success",
  "data":null
 } 

失败1 - 挖矿码不存在

{
  "code" : 2101 ,
  "message":"it not exits",
  "data":null
 } 

失败2 - 挖矿码已经被绑定

{
  "code" : 2102 ,
  "message":"it belong to others",
  "data":null
 } 

失败2

钱包

请求：

• url: https://ip:port/pocket
• 请求方式: POST
• 数据格式：json
• 参数类型

参数	类型	必须	说明
phoneNumber	string	是	手机号码
token	string	是

• 参数例子

{
 "phoneNumber":"××××××"，
 "token":"××××××"
}

返回:

参数	类型	必须	说明
code	int	是	代表当前请求的反馈结果，详解后文returecode
balance	string	是	钱包余额(需要前端string—>float64)
takeOutReady	string	是	待提现的金额(需要前端string—>float64)

• 成功：

{
  "code" : 0 ,
  "message":"welcome",
  "data":{
      "balance":"××××××" ,
      "takeOutReady":"××××××"
    }
 } 

钱包——挖矿收益

请求：

• url: https://ip:port/pocket/minnerIncomRecord
• 请求方式: POST
• 数据格式：json
• 参数类型

参数	类型	必须	说明
phoneNumber	string	是	手机号码
token	string	是

• 参数例子

{
 "phoneNumber":"××××××"，
 "token":"××××××"
}

返回:

参数	类型	必须	说明
code	int	是	代表当前请求的反馈结果，详解后文returecode
income	string	是	挖矿收益(需要前端string—>float64)
machineId	int	是	矿机编号
totalincom	string	是	总的挖矿收益(需要前端string—>float64)
yestodayincom	string	是	昨天的收益(需要前端string—>float64)
date	string	是	收益日期

• 成功：

{
  "code" : 0 ,
  "message":"welcome",
  "data":{
       "totalincom":"",
        "yestodayincom":"",
      "history":[
          {"machineId":——,"income":——,"date":"××××××"},
          {"machineId":——,"income":——,"date":"××××××"},
          {"machineId":——,"income":——,"date":"××××××"}
      ]
    }
 }

钱包——提现首页

请求：

• url: https://ip:port/pocket/takeoutindex
• 请求方式: POST
• 数据格式：json
• 参数类型

参数	类型	必须	说明
phoneNumber	string	是	手机号码
token	string	是

返回:

参数	类型	必须	说明
code	int	是	代表当前请求的反馈结果，详解后文returecode
balance	float64	是	钱包余额
ethaddress	string	是	将要提现至的eth地址
limit	float64	是	今日的提现上限
fee	string	是	提现的手续费

• 成功：

{
  "code" : 0 ,
  "message":"welcome",
  "data":{
       "balance":"××××××",
       "ethaddress":"××××××",
       "limit":______,
       "fee":"××××××",
     
    }
 } 

钱包——提现首页——查看提现历史

请求：

• url: https://ip:port/pocket/takeoutindex/history
• 请求方式: POST
• 数据格式：json
• 参数类型

参数	类型	必须	说明
phoneNumber	string	是	手机号码
token	string	是

返回:

参数	类型	必须	说明
code	int	是	代表当前请求的反馈结果，详解后文returecode
history	json数组	是
date	string	是	提现时间
amount	float64	是	提现的数量
status	int	是	提现的状态(1-Wait,2-success,3-false)

• 成功：

{
  "code" : 0 ,
  "message":"welcome",
  "data":{
      history:[
           {"date":"××××××","amount":"××××××","Statust":1},   
          {"date":"××××××","amount":"××××××","Statust":2},   
          {"date":"××××××","amount":"××××××","Statust":3},   
        ] 
    }
 } 

钱包——提现首页——执行提现

请求：

• url: https://ip:port/pocket/takeoutindex/takeout
• 请求方式: POST
• 数据格式：json
• 参数类型

参数	类型	必须	说明
phoneNumber	string	是	手机号码
checkCode	string	是	提现验证码
amount	string	是	提现的数量
token	string	是

返回:

参数	类型	必须	说明
code	int	是	代表当前请求的反馈结果，详解后文returecode

• 成功：

{
  "code" : 0 ,
  "message":"success",
  "data":null
 } 

我的

请求：

• url: https://ip:port/mine
• 请求方式: POST
• 数据格式：json
• 参数类型

参数	类型	必须	说明
phoneNumber	string	是	手机号码
token	string	是

• 参数例子

{
 "phoneNumber":"××××××"，
 "token":"××××××"
}

返回:

参数	类型	必须	说明
code	int	是	代表当前请求的反馈结果，详解后文returecode
userName	string	是	如果用户没有设置用户名，则显示为空
ethAddress	string	是	用户的eth地址
minnerCode	string	是	用户的挖矿码，如果没有则显示为空
phoneNumber	string	是	用户的手机号码

{
  "code" : 0 ,
  "message":"minner history",
  "data":{
      "userName":"××××××",
      "ethAddress":"××××××",
      "minnerCode":"××××××",
      "phoneNumber":"××××××"
    }
 } 

我的——上传更新头像

请求：

• url: https://ip:port/mine/uploadimg
• 请求方式: POST
• 数据格式：multipart/form-data
• 参数类型

参数	类型	必须	说明
phoneNumber	string	是	手机号码
token	string	是
userid	string	是	登录时服务端返回的userid
image	file	是	上传的头像图片，用file类型上传（该file的name必须为user.img）

• 参数例子

{
 "phoneNumber":"××××××"，
 "token":"××××××",
 "userid":"××××××",
}

返回:

参数	类型	必须	说明
code	int	是	代表当前请求的反馈结果，详解后文returecode
imgurl	string	是	请求头像的url

成功：

{
  "code" : 0 ,
  "message":"minner history",
  "data":null
 } 

失败：

{
  "code" : 304 ,
  "message":"minner history",
  " data":{
    "imgurl":"××××××"  
  }
 } 

我的——修改手机号码

调用该API之前，要先请求校验码

请求：

• url: https://ip:port/mine/updatePhonenumber
• 请求方式: POST
• 数据格式：multipart/form-data
• 参数类型

参数	类型	必须	说明
phoneNumber	string	是	原手机号码
newPhoneNumber	string	是	新手机号码
newAreaCode	string	是	新手机号码的国际码
checkCode	string	是	校验码
token	string	是

• 参数例子

{
 "phoneNumber":"××××××"，
 "newPhoneNumber":"××××××"，
 "token":"××××××",
 "newAreaCode" :"××××××",
"checkCode":"××××××",
}

返回:

参数	类型	必须	说明
code	int	是	代表当前请求的反馈结果，详解后文returecode

成功：

{
  "code" : 0 ,
  "message":"success",
  "data":null
 } 

失败：

{
  "code" : 305,
  "message":"failed",
  "data":null
 } 

我的——修改密码

调用该API之前，要先请求校验码

请求：

• url: https://ip:port/mine/updatePassword
• 请求方式: POST
• 数据格式：multipart/form-data
• 参数类型

参数	类型	必须	说明
phoneNumber	string	是	原手机号码
password	string	是	旧密码
newPassword	string	是	新密码
checkCode	string	是	校验码
areacode	string	是	区码
token	string	是

• 参数例子

{
 "phoneNumber":"××××××"，
 "password":"××××××"，
 "newPassword":"××××××"，
 "token":"××××××",
 "checkCode":"××××××",
}

返回:

参数	类型	必须	说明
code	int	是	代表当前请求的反馈结果，详解后文returecode

成功：

{
  "code" : 0 ,
  "message":"success",
  "data":null
 } 

失败：

{
  "code" : 306,
  "message":"failed",
  "data":null
 } 

我的——修改昵称

请求：

• url: https://ip:port/mine/updateUserName
• 请求方式: POST
• 数据格式：Json
• 参数类型

参数	类型	必须	说明
phoneNumber	string	是	原手机号码
username	string	是	新的用户名
token	string	是

• 参数例子

{
 "phoneNumber":"××××××"，
 "username":"××××××"，
 "token":"××××××",
}

返回:

参数	类型	必须	说明
code	int	是	代表当前请求的反馈结果，详解后文returecode

成功：

{
  "code" : 0 ,
  "message":"success",
  "data":null
 } 

我的——我的挖矿码

• url: https://ip:port/mine/getMyMinnerCode
• 请求方式: POST
• 数据格式：Json
• 参数类型

参数	类型	必须	说明
phoneNumber	string	是	手机号码
areacode	string	是	手机区号
token	string	是

• 参数例子

{
 "phoneNumber":"××××××"，
 "areacode":"××××××"，
 "token":"××××××",
}

返回:

参数	类型	必须	说明
code	int	是	代表当前请求的反馈结果，详解后文returecode

成功：

{
    "RetCode":"0",
    "Description":"get arrayMinnerCode success",
    "Err":"",
    "data":{
        "CodeList":[
            {
                "code":"123123123"
            }
        ]
    }
}

• 请求方式: POST
• 数据格式：Json
• 参数类型

参数	类型	必须	说明
phoneNumber	string	是	原手机号码
username	string	是	新的用户名
token	string	是

• 参数例子

{
 "phoneNumber":"××××××"，
 "username":"××××××"，
 "token":"××××××",
}

返回:

参数	类型	必须	说明
code	int	是	代表当前请求的反馈结果，详解后文returecode

成功：

{
  "code" : 0 ,
  "message":"success",
  "data":null
 } 

返回码

有些接口返回code 有些是RetCode 请注意区分

• 用户登录
  0 登录成功
  302 登录失败（对于为空的情况，前后端皆会做判断）

• token过期
  303 token过期

• 检查版本号
  0 成功

• 用户注册 ——请求获取验证码
  0 成功发送验证码
  315 不存在的手机号码

• 用户注册 ——校验 验证码 并 设置密码
  0 成功
  413 失败，验证码与手机号码不匹配或者手机号码已经被注册

• 忘记密码—— 请求获取验证码
  0 成功发送验证码
  315 不存在的手机号码

• 忘记密码——修改密码
  0 成功修改密码
  414 验证码与手机号码不匹配

• 首页
  0 返回首页需要的状态信息

• 首页——预约抢码应用
  200 需要绑定ETH地址
  201 已绑定ETH地址，但还没有参与抢码活动
  2020 还未开奖
  2022 已开奖，但未中奖
  0 已开奖，且中奖

• 预约抢码 ——预约抢码应用——绑定ETH
  0 成功绑定账户
  2000 验证账户BCDN数额不通过，余额不足
  2002 验证账户BCDN数额，错误的以太坊账户

• 预约抢码 ——预约抢码应用——预约抢码
  0 成功获得预约码

• 钱包
  0

• 钱包-挖矿收益
  0

• 我的
  0

• 我的——上传新头像
  0 成功
  304 头像上传失败

• 我的——修改手机号码
  0 成功
  305 失败

备注:

• 服务器返回的时间都是时间戳
• 资产导入查询到的BCDN是通过公式 1BTC * 61000 + 1ETH * 5000 + BCDN = ?BCDN计算出来的