短信验证码
接口说明
[!NOTE]
获取短信验证码接口。
http请求方式
[!NOTE]
POST application/x-www-form-urlencoded
http请求地址
[!NOTE]
$SERVICE_URL/v2/auth/smsVerify #其中$SERVICE_URL为生产或测试的地址
http请求参数
除公共必填参数外,还需要传以下参数
参数 | 类型 | 是否必填 | 默认值 | 说明 |
---|---|---|---|---|
target | String | * | 手机号 |
代码实现
JAVA实现
RequestUtils requestUtils=RequestUtils.init(SERVICE_URL,APP_KEY,APP_SECRET);//建议生成为spring bean
//构建请求参数
Map<String, Object> params = bodyParams;
String url = SERVICE_URL + "/v2/auth/smsVerify";
params.put("target","1862XXXXX");//手机号
String str= HttpClientUtils.init().getPost(url,null,params,true);
System.out.println(str);
http返回参数
[!NOTE]
返回response为application/json的数据,其字段说明如下
参数 | 类型 | 是否必返回 | 说明 |
---|---|---|---|
success | boolean | * | 成功true;异常false |
data | json | * | 响应内容json |
[!NOTE]
data字段说明如下
参数 | 类型 | 是否必返回 | 说明 |
---|---|---|---|
orderNo | String | * | 流水号 |
code | String | * | 验证码 |
[!NOTE]
返回结果,参考:
//正确响应:
{"data":{"code":"250321","orderNo":"7DBFAD2C983E4B77A365443178FF5904"},"success":true}
//错误响应:
{"msg":"target手机类型格式错误","resultCode":"BUSINESS_ERROR","success":false}