API

作者: 放开那个女巫 | 来源:发表于2017-11-28 20:21 被阅读0次

（2）智能合约开发：API 参考大纲
06JavaScript-同步、异步、回调、Promise、as
Clinic Api
13-Runtime(API)
Kubernetes REST API
JS-API、DOM-day07-5.6
Web API(备忘)
JAVA基础---API String StringBuil
STL算法之常用拷贝和替换
智能聊天机器人的技术及专业术语解释

对外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 失败