## 请求地址

|名称|值|
|----|----|
|HTTP URL|[http://ye.dun.163.com/v1/check](http://ye.dun.163.com/v1/check)|
|HTTP Method|POST|

## 请求头

|名称|类型|描述|
|----|----|----|
|Content-Type|String|固定值："application/x-www-form-urlencoded"|

## 接口描述

该接口主要包括两个功能：

- 验证token是否有效

- 验证手机号并返回结果

## 请求参数
公共参数已省略，详细见[请求公共参数](https://support.dun.163.com/documents/287305921855672320?docId=289953034527756288)，其他参数如下：

| 参数名称        | 类型    | 是否必选 | 最大长度 | 描述      |
| ----------- | ------ | ---- | ---- | ------- |
| token       | String | Y    | 32   | 易盾token |
| accessToken | String | Y    | 2048 | 运营商授权码  |
| phone       | String | Y    | 11   | 手机号     |

## 响应结果
响应字段如下，响应通用字段已省略，详细见[响应通用字段](https://support.dun.163.com/documents/287305921855672320?docId=289953034527756288#%E5%93%8D%E5%BA%94%E9%80%9A%E7%94%A8%E5%AD%97%E6%AE%B5)：

data 数据结构

| 参数名称   | 类型     | 描述                                       |
| ------ | ------ | ---------------------------------------- |
| result | Number | 验证结果 1-通过;2-不通过;3-无法确认(结果不为1时建议做二次校验,例如短信验证码检验等) |



### 响应示例
当请求成功时，输出示例如下：
```json
{
  "code": 200,
  "msg": "ok",
  "data": {
    "result": 1
  }
}
```
## 接入示例代码

### 服务端 SDK 接入

推荐使用我们提供的服务端 SDK 进行接入（目前支持 Java 和 Go 两种语言），不但可以节省接入成本，实现更快速的集成，并享有灵活的请求配置选项，同时 SDK 内置了错误重试、熔断降级等功能，提升服务可用性。点击 [服务端 SDK 接入指引](https://support.dun.163.com/documents/287305921855672320?docId=682781209345695744) 了解更多。 

#### Github Demo 地址   
- [Java SDK Demo](https://github.com/yidun/yidun-java-sdk/blob/main/yidun-java-sdk-demo/src/main/java/com/netease/yidun/sdk/mobileverify/mobilenumberverify/v1/MobileNumberVerifyDemo.java)
- [Golang SDK Demo](https://github.com/yidun/yidun-golang-sdk/blob/main/yidun/demo/mobileverify/numberverify/mobile_number_verify_demo.go)

#### Gitee地址（Github无法访问时选择）
- [Java SDK Demo](https://gitee.com/netease_yidun/yidun-java-sdk/blob/main/yidun-java-sdk-demo/src/main/java/com/netease/yidun/sdk/mobileverify/mobilenumberverify/v1/MobileNumberVerifyDemo.java)
- [Golang SDK Demo](https://gitee.com/netease_yidun/yidun-golang-sdk/blob/main/yidun/demo/mobileverify/numberverify/mobile_number_verify_demo.go)