调用VerifyMobile完成本机号码校验认证。

准备工作

请先完成阿里云账号注册、获取阿里云访问密钥、创建认证方案,更多信息,请参见快速入门

说明 该接口仅适用于本机号码校验,如果您想使用一键登录,请参考一键登录API。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String VerifyMobile

系统规定参数,取值:VerifyMobile

AccessCode String Dfafdafad5422525

App端SDK获取AccessCode参数值,即Token。

PhoneNumber String 13800****00

手机号。

OutId String 123456

外部流水号。

返回数据

名称 类型 示例值 描述
Code String OK

状态码。

  • 返回OK代表请求成功。
  • 其他错误码,请参见错误码列表
GateVerifyResultDTO Struct

结构体。

VerifyId String 121343241

流水号。

VerifyResult String PASS

认证结果。

  • PASS:一致。
  • REJECT:不一致。
  • UNKNOWN:无法判断。
Message String 请求成功

状态码的描述。

RequestId String 8906582E-6722

请求ID。

示例

请求示例

http(s)://dypnsapi.aliyuncs.com/?Action=VerifyMobile
&AccessCode=Dfafdafad5422525
&PhoneNumber=13800****00
&<公共请求参数>

正常返回示例

XML格式

<VerifyMobileResponse>
  <GateVerifyResultDTO>
        <VerifyResult>PASS</VerifyResult>
        <VerifyId>121343241</VerifyId>
  </GateVerifyResultDTO>
  <Message>请求成功</Message>
  <RequestId>8906582E-6722</RequestId>
  <Code>OK</Code>
</VerifyMobileResponse>

JSON格式

{
    "GateVerifyResultDTO": {
        "VerifyResult": "PASS",
        "VerifyId": 121343241
    },
    "Message": "请求成功",
    "RequestId": 8906582,
    "Code": "OK"
}

错误码

访问错误中心查看更多错误码。

JAVA SDK MAVEN 坐标


<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-core</artifactId>
    <version>4.5.2</version>
</dependency>
<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-dypnsapi</artifactId>
    <version>1.2.1</version>
</dependency>