核验短信验证码,需要配合短信验证码,使用,此接口不扣费。
返回首页
核验短信验证码
请求示例
curl -X POST https://api.zhuimengapi.com/api/v1/check \
-H "X-API-Key: RPA-xxxxxxxx"
-H "Content-Type: application/json"
-d '{
"phone_number": "接收验证码的手机号,必须与发送时的号码一致",
"verify_code": "用户输入的验证码。注意:发送时用##code##占位符生成的验证码,发送时传固定值则无法校验,需自行比对",
"scheme_name": "方案名称,最长20字符。重要:若发送时传了此字段,校验时必须与发送接口的方案名称一致",
"country_code": "国家编码,默认86",
"case_auth_policy": 0,
"out_id": "外部流水号,透传"
}'import requests
url = "https://api.zhuimengapi.com/api/v1/check"
headers = {"X-API-Key": "RPA-xxxxxxxx", "Content-Type": "application/json"}
data = {
"phone_number": "接收验证码的手机号,必须与发送时的号码一致",
"verify_code": "用户输入的验证码。注意:发送时用##code##占位符生成的验证码,发送时传固定值则无法校验,需自行比对",
"scheme_name": "方案名称,最长20字符。重要:若发送时传了此字段,校验时必须与发送接口的方案名称一致",
"country_code": "国家编码,默认86",
"case_auth_policy": 0,
"out_id": "外部流水号,透传"
}
res = requests.post(url, json=data, headers=headers)
print(res.json())const axios = require('axios');
axios.post("https://api.zhuimengapi.com/api/v1/check", {
"phone_number": "接收验证码的手机号,必须与发送时的号码一致",
"verify_code": "用户输入的验证码。注意:发送时用##code##占位符生成的验证码,发送时传固定值则无法校验,需自行比对",
"scheme_name": "方案名称,最长20字符。重要:若发送时传了此字段,校验时必须与发送接口的方案名称一致",
"country_code": "国家编码,默认86",
"case_auth_policy": 0,
"out_id": "外部流水号,透传"
}, {
headers: { "X-API-Key": "RPA-xxxxxxxx", "Content-Type": "application/json" }
}).then(res => console.log(res.data));响应示例
{
"Code": "接口请求状态码。返回OK代表请求成功,其他错误码请参见返回码。重要:接口请求成功不代表短信验证码核验成功,短信验证码核验结果仅以Model.VerifyResult参数返回值为准",
"Message": "状态码的描述",
"Success": false,
"RequestId": "请求ID",
"AccessDeniedDetail": "访问被拒绝详细信息",
"Model": {
"VerifyResult": "短信验证码核验结果。PASS:短信验证码核验成功,UNKNOWN:短信验证码核验失败",
"OutId": "外部流水号"
}
}
接口信息
请求地址
https://api.zhuimengapi.com/api/v1/check
请求方式
POST
Content-Type
application/json
鉴权方式
X-API-Key: RPA-xxxxxxxx
请求参数
phone_number
string
必填 接收验证码的手机号,必须与发送时的号码一致
verify_code
string
必填 用户输入的验证码。注意:发送时用##code##占位符生成的验证码,发送时传固定值则无法校验,需自行比对
scheme_name
string
方案名称,最长20字符。重要:若发送时传了此字段,校验时必须与发送接口的方案名称一致
country_code
string
国家编码,默认86
case_auth_policy
int
大小写字母核验策略:1=不区分大小写,2=区分大小写
out_id
string
外部流水号,透传
返回字段
Code
string
必填 接口请求状态码。返回OK代表请求成功,其他错误码请参见返回码。重要:接口请求成功不代表短信验证码核验成功,短信验证码核验结果仅以Model.VerifyResult参数返回值为准
Message
string
必填 状态码的描述
Success
boolean
必填 接口调用是否成功。true:接口调用成功,false:接口调用失败。重要:接口调用成功不代表短信验证码核验成功,短信验证码核验结果仅以Model.VerifyResult参数返回值为准
RequestId
string
必填 请求ID
AccessDeniedDetail
string
访问被拒绝详细信息
Model
object
请求结果数据
VerifyResult
string
短信验证码核验结果。PASS:短信验证码核验成功,UNKNOWN:短信验证码核验失败
OutId
string
外部流水号
响应状态说明
不同接口的成功返回字段可能不同,请以本接口的响应示例和实际结果为准。请求失败时使用下方统一错误结构,失败调用不计费。
- 200 请求成功返回字段以本接口的响应示例和实际结果为准,部分接口不包含 code 字段。 按接口规则计费
- 400 参数或业务错误请求参数无效时返回安全、明确的修正提示。 不扣费
- 401 API Key 无效密钥缺失、格式错误、无效或已经过期。 不扣费
- 402 账户余额不足请充值后重试;本次请求不会进入接口处理。 不扣费
- 403 访问被拒绝IP 规则限制,或当前账户无权调用仅限 VIP 的接口。 不扣费
- 404 接口路由不存在请检查请求地址中的 API 路由是否正确。 不扣费
- 405 请求方法不支持请按照接口文档使用允许的 GET 或 POST 方法,并查看 Allow 响应头。 不扣费
- 413 请求体过大单次请求最大允许 20MB。 不扣费
- 429 请求频率超限请根据 Retry-After 响应头稍后重试。 不扣费
- 500 系统服务异常请稍后重试;持续出现时请向技术支持提供 request_id。 不扣费
- 502 接口服务暂时不可用接口处理异常或暂时不可用,请稍后重试。 不扣费
- 503 系统服务暂时不可用服务正在恢复,请稍后重试。 不扣费
错误响应示例
使用 request_id 查询对应调用日志
{
"code": 400,
"message": "请输入有效的身份证号码",
"data": null,
"request_id": "1-xxxxxxxx",
"time": "2026-07-29 12:00:00"
}
请求地址
https://api.zhuimengapi.com/api/v1/check
请求方式
POST
Content-Type
application/json
鉴权 Header
X-API-Key
Params
GET 请求只通过 URL 查询参数发送
Body JSON 模式
POST + application/json 使用原始 JSON 请求体
request body (JSON)
快速信息
| 接口路由 | check |
| 接口分类 | - |
| 请求方式 | POST |
| 计费方式 | 免费 |
| 频率限制 | 不限制 |
| 认证方式 | X-API-Key |
| 接口提供 | 官方接口 |