<a name="oj0Bd"></a>
### 1、接口描述
协议：HTTPS Post from-data 接口地址：[https://api.253.com/open/wool/yzm](https://api.253.com/open/wool/yzm)

<a name="jbxBR"></a>
### 2、输入参数
| 参数名 | 类型 | 说明 |
| --- | --- | --- |
| appId | string | 应用id |
| appKey | string | 应用key |
| AppSecretKey | string | 验证码密钥（咨询对接人员） |
| CaptchaAppId | string | 验证码appId（咨询对接人员） |
| RendStr | string | 验证票据需要的随机字符串 |
| Ticket | string | 验证码返回给用户的票据 |
| IP | string | 用户操作来源的外网 IP |


输出参数

| 参数名 | 类型 | 说明 |
| --- | --- | --- |
| tradeNo | string | 交易流水号 |
| chargeStatus | string | 是否收费 1收费，0不收费 |
| message | string | 验证码密钥（咨询对接人员） |
| CaptchaMsg | string | 状态描述及验证错误信息 注意：此字段可能返回 null，表示取不到有效值。 |
| EvilLevel | Integer | [0,100]，恶意等级 注意：此字段可能返回 null，表示取不到有效值。 |
| RequestId | string | 验证码系统返回的唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
| CaptchaCode | Integer | 1 OK 验证通过 6 user code len error 验证码长度不匹配 7 captcha no match 验证码答案不匹配/Randstr参数不匹配 8 verify timeout 验证码签名超时 9 Sequnce repeat 验证码签名重放 10 Sequnce invalid 验证码签名序列 11 Cookie invalid 验证码cooking信息不合法 12 sig len error 签名长度错误 13 verify ip no match ip不匹配 15 decrypt fail 验证码签名解密失败 16 appid no match 验证码强校验appid错误 17 cmd no much 验证码系统命令不匹配 18 uin no match 号码不匹配 19 seq redirect 重定向验证 20 opt no vcode 操作使用pt免验证码校验错误 21 diff 差别，验证错误 22 captcha type not match 验证码类型与拉取时不一致 23 verify type error 验证类型错误 24 invalid pkg 非法请求包 25 bad visitor 策略拦截 26 system busy 系统内部错误 100 param err appsecretkey 参数校验错误 |
| code | 

 | 响应code码 200000 请求成功 400001 参数校验异常 400101 商户信息不存在 400102 商户IP地址不合法 400200 黑名单列表 400201 手机号码不能为空 400901 账户信息不存在 400902 应用类型信息不存在 403000 用户校验失败 403101 账户被系统禁用 403102 账户未激活 415000 请求数据转换异常 500000 系统异常 500002 数据处理异常 500003 业务操作失败 500004 远程调用失败 500005 账户余额异常 500006 请求外部系统失败 500901 邮箱未设置 500902 账户信息已存在 500903 账户相关能力已激活 504000 系统超时 510101 用户产品可用数量不足 |

返回示例: 正常:
```json
{
 tradeNo: "656221037519835137",
 chargeStatus: 1,
 message: "成功",
 data: {
 CaptchaMsg: "OK",
 EvilLevel: 0,
 RequestId: "984d6957-902c-4be8-af3a-012309b63d80",
 CaptchaCode: 1
 },
 code: "200000"
}
```


验证码CaptchaAppId、AppSecretKey错误:
```json
{
 tradeNo: "656198616582455296",
 chargeStatus: 1,
 message: "成功",
 data: {
 CaptchaMsg: "SecretKeyCheck Error",
 EvilLevel: 0,
 RequestId: "e82f459a-cbf5-4167-9a9e-1d2c1bbdf9bd",
 CaptchaCode: 100
 },
 code: "200000"
}
```


验证码ticket超时，需要重新获取:
```json
{
 tradeNo: "656221420577095680",
 chargeStatus: 1,
 message: "成功",
 data: {
 CaptchaMsg: "verify timeout",
 EvilLevel: 0,
 RequestId: "060352db-3767-4a3c-bd31-3beb624b17ce",
 CaptchaCode: 8
 },
 code: "200000"
}
```


Ticket和rendStr不一致，返回示例:
```json
{
 tradeNo: "656222083289710592",
 chargeStatus: 1,
 message: "成功",
 data: {
 CaptchaMsg: "decrypt fail",
 EvilLevel: 0,
 RequestId: "593dd626-8563-4f4d-9f17-6fe3a216937a",
 CaptchaCode: 15
 },
 code: "200000"
}
```

<!doctype html><div class="lake-content" typography="classic"><h3 id="oj0Bd">1、接口描述</h3>协议：HTTPS Post from-data 接口地址：<a href="https://api.253.com/open/wool/yzm" data-href="https://api.253.com/open/wool/yzm" target="_blank" class="ne-link">https://api.253.com/open/wool/yzm</a><h3 id="jbxBR">2、输入参数</h3><table id="SNAcr" class="ne-table" style="width: 720px"><tbody><tr style="height: 33px"><td width="114">参数名</td><td width="114">类型</td><td width="492">说明</td></tr><tr style="height: 33px"><td width="114">appId</td><td width="114">string</td><td width="492">应用id</td></tr><tr style="height: 33px"><td width="114">appKey</td><td width="114">string</td><td width="492">应用key</td></tr><tr style="height: 33px"><td width="114">AppSecretKey</td><td width="114">string</td><td width="492">验证码密钥（咨询对接人员）</td></tr><tr style="height: 33px"><td width="114">CaptchaAppId</td><td width="114">string</td><td width="492">验证码appId（咨询对接人员）</td></tr><tr style="height: 33px"><td width="114">RendStr</td><td width="114">string</td><td width="492">验证票据需要的随机字符串</td></tr><tr style="height: 33px"><td width="114">Ticket</td><td width="114">string</td><td width="492">验证码返回给用户的票据</td></tr><tr style="height: 33px"><td width="114">IP</td><td width="114">string</td><td width="492">用户操作来源的外网 IP</td></tr></tbody></table>输出参数<table id="TXhFo" class="ne-table" style="width: 720px"><tbody><tr style="height: 33px"><td width="114">参数名</td><td width="115">类型</td><td width="491">说明</td></tr><tr style="height: 33px"><td width="114">tradeNo</td><td width="115">string</td><td width="491">交易流水号</td></tr><tr style="height: 33px"><td width="114">chargeStatus</td><td width="115">string</td><td width="491">是否收费 1收费，0不收费</td></tr><tr style="height: 33px"><td width="114">message</td><td width="115">string</td><td width="491">验证码密钥（咨询对接人员）</td></tr><tr style="height: 33px"><td width="114">CaptchaMsg</td><td width="115">string</td><td width="491">状态描述及验证错误信息 注意：此字段可能返回 null，表示取不到有效值。</td></tr><tr style="height: 33px"><td width="114">EvilLevel</td><td width="115">Integer</td><td width="491">[0,100]，恶意等级 注意：此字段可能返回 null，表示取不到有效值。</td></tr><tr style="height: 33px"><td width="114">RequestId</td><td width="115">string</td><td width="491">验证码系统返回的唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。</td></tr><tr style="height: 33px"><td width="114">CaptchaCode</td><td width="115">Integer</td><td width="491">1 OK 验证通过 6 user code len error 验证码长度不匹配 7 captcha no match 验证码答案不匹配/Randstr参数不匹配 8 verify timeout 验证码签名超时 9 Sequnce repeat 验证码签名重放 10 Sequnce invalid 验证码签名序列 11 Cookie invalid 验证码cooking信息不合法 12 sig len error 签名长度错误 13 verify ip no match ip不匹配 15 decrypt fail 验证码签名解密失败 16 appid no match 验证码强校验appid错误 17 cmd no much 验证码系统命令不匹配 18 uin no match 号码不匹配 19 seq redirect 重定向验证 20 opt no vcode 操作使用pt免验证码校验错误 21 diff 差别，验证错误 22 captcha type not match 验证码类型与拉取时不一致 23 verify type error 验证类型错误 24 invalid pkg 非法请求包 25 bad visitor 策略拦截 26 system busy 系统内部错误 100 param err appsecretkey 参数校验错误</td></tr><tr style="height: 33px"><td width="114">code</td><td width="115"> </td><td width="491">响应code码200000 请求成功 400001 参数校验异常400101 商户信息不存在 400102 商户IP地址不合法 400200 黑名单列表 400201 手机号码不能为空 400901 账户信息不存在 400902 应用类型信息不存在 403000 用户校验失败403101 账户被系统禁用 403102 账户未激活 415000 请求数据转换异常 500000 系统异常 500002 数据处理异常 500003 业务操作失败 500004 远程调用失败 500005 账户余额异常 500006 请求外部系统失败 500901 邮箱未设置 500902 账户信息已存在 500903 账户相关能力已激活 504000 系统超时 510101 用户产品可用数量不足</td></tr></tbody></table>返回示例:正常:<pre data-language="json" id="m2qRU" class="ne-codeblock language-json">{
 tradeNo: &quot;656221037519835137&quot;,
 chargeStatus: 1,
 message: &quot;成功&quot;,
 data: {
 CaptchaMsg: &quot;OK&quot;,
 EvilLevel: 0,
 RequestId: &quot;984d6957-902c-4be8-af3a-012309b63d80&quot;,
 CaptchaCode: 1
 },
 code: &quot;200000&quot;
}</pre> 验证码CaptchaAppId、AppSecretKey错误:<pre data-language="json" id="aB07m" class="ne-codeblock language-json">{
 tradeNo: &quot;656198616582455296&quot;,
 chargeStatus: 1,
 message: &quot;成功&quot;,
 data: {
 CaptchaMsg: &quot;SecretKeyCheck Error&quot;,
 EvilLevel: 0,
 RequestId: &quot;e82f459a-cbf5-4167-9a9e-1d2c1bbdf9bd&quot;,
 CaptchaCode: 100
 },
 code: &quot;200000&quot;
}</pre> 验证码ticket超时，需要重新获取:<pre data-language="json" id="dx9f2" class="ne-codeblock language-json">{
 tradeNo: &quot;656221420577095680&quot;,
 chargeStatus: 1,
 message: &quot;成功&quot;,
 data: {
 CaptchaMsg: &quot;verify timeout&quot;,
 EvilLevel: 0,
 RequestId: &quot;060352db-3767-4a3c-bd31-3beb624b17ce&quot;,
 CaptchaCode: 8
 },
 code: &quot;200000&quot;
}</pre> Ticket和rendStr不一致，返回示例:<pre data-language="json" id="YP037" class="ne-codeblock language-json">{
 tradeNo: &quot;656222083289710592&quot;,
 chargeStatus: 1,
 message: &quot;成功&quot;,
 data: {
 CaptchaMsg: &quot;decrypt fail&quot;,
 EvilLevel: 0,
 RequestId: &quot;593dd626-8563-4f4d-9f17-6fe3a216937a&quot;,
 CaptchaCode: 15
 },
 code: &quot;200000&quot;
}</pre> </div>

1、接口描述协议：HTTPS Post from-data接口地址：https://api.253.com/open/wool/yzm2、输入参数参数名类型说明appIdstring应用idappKeystring应用keyAppSecretKeystring验证码密钥（咨询对接人员）Capt...

服务端接入

使用入门

功能介绍

开发文档

常见问题

羊毛盾标准版

客户端接入

图文验证码

认证安全

创蓝云智，为企业提供全面的数据接口API/SDK。免费试用，满意为止。致力于让企业更高效高质量的获得用户及触达用户。

注册登录

新客获客

老客激活

金融行业

游戏行业

电商行业

餐饮行业

私有云

服务端接入