Authored by tanling

实名认证接口文档

## 1、发送短信验证码##
发送短信验证码(method=app.message.sendSms
发送短信验证码(method=app.passport.smsbind
#### 公共请求参数
| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |
|:-------| -----:|-----:|-----:|-----:|-----:|----:|
... ... @@ -30,20 +30,26 @@
|500|参数缺失|
注意,通用的头部没有列出。
请求示例
?method=app.message.sendSms&profile=18021522255&area=86
?method=app.passport.smsbind&mobile=13861473861&area=86&type=1
### 响应
code为200即为成功,否则是失败。
响应参数,data部分
响应成功JSON格式如下所示:
```json
{
"alg": "SALT_MD5",
"code": 200,
"data": [],
"md5": "6d729d4b35f10fc73531210bd7ecff91",
"message": "发送成功."
}
{
"alg": "SALT_MD5",
"code": 200,
"data":
[
],
"md5": "6d729d4b35f10fc73531210bd7ecff91",
"message": "发送成功"
}
```
响应失败JSON格式如下所示:
```json
... ...
## 1、校验是否是注册用户##
## 1、检查手机号码是否可绑定##
校验是否是注册用户(method=app.passport.checkUserExist
检查手机号码是否可绑定(method=app.passport.checkBindByMobile
#### 公共请求参数
| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |
|:-------| -----:|-----:|-----:|-----:|-----:|----:|
... ... @@ -29,7 +29,7 @@
|500|参数缺失|
注意,通用的头部没有列出。
请求示例
?method=app.passport.checkUserExist&mobile=18021522255&area=86
?method=app.passport.checkBindByMobile&mobile=18021522255&area=86
### 响应
code为200即为成功,否则是失败。
... ... @@ -40,7 +40,7 @@ code为200即为成功,否则是失败。
"alg": "SALT_MD5",
"code": 200,
"data": {
"is_register":"Y" // Y-已注册,N-未注册
"isCanBind":"Y" // Y-可以绑定,N-不可以
},
"md5": "6d729d4b35f10fc73531210bd7ecff91",
"message": "发送成功."
... ...
## 1、绑定手机号码##
绑定手机号码(method=app.passport.changeMobile)
#### 公共请求参数
| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |
|:-------| -----:|-----:|-----:|-----:|-----:|----:|
|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息|
|app_version|float|10|否|1||APP版本|
|os_version|string|20|否|Android4.4||系统版本+机器型号|
|client_type|string|20|否|iphone/android/ipad||手机型号(不区分大小写)|
|screen_size|string|20|否|800x900||(手机尺寸)|
#### 请求参数
| 参数名称 | 参数类型 |长度| 可否为空 | 示例 | 默认值 | 备注 |
|:-------| -----:|-----:|-----:|-----:|-----:|----:|
|mobile|String|1-11|否|18021522255||手机|
|area|String|1-11|是|86|86|国家码|
|code|String|1-11|否|1||短信验证码|
|uid|String|1-11|否|1234333||用户uid|
#### 接口说明
| 接口说明||
|:-------| -----:|
|请求域名|http://api.yoho.cn|
|接口名|app.message.sendSms|
|接口说明|发送短信验证码|
|http请求方式|POST/GET|
#### 返回错误
|错误code|错误提示|
|:-------| -----:|
|500|参数缺失|
注意,通用的头部没有列出。
请求示例
?method=app.passport.changeMobile&profile=18021522255&area=86&uid=20000904&&code=3469
### 响应
code为200即为成功,否则是失败。
响应参数,data部分
响应成功JSON格式如下所示:
```json
{
"alg": "SALT_MD5",
"code": 200,
"data":
{
"email": "",
"mobile": "13861473861",
"session_key": "008a261d2f9f513192829da47b4ea500",
"uid": 20000904
},
"md5": "44a72e05082dac6ef772798a96e568fe",
"message": "手机号修改成功!"
}
```
响应失败JSON格式如下所示:
```json
{
"message":"参数缺失",
"code":500
}
```
... ...