返回首页

核验短信验证码

/api/v1/check 免费 运行中

核验短信验证码,需要配合短信验证码,使用,此接口不扣费。

请求示例

request
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));

响应示例

response.json
{
    "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 Body
Params GET 请求只通过 URL 查询参数发送
Body JSON 模式 POST + application/json 使用原始 JSON 请求体
request body (JSON)

快速信息

接口路由check
接口分类-
请求方式POST
计费方式免费
频率限制不限制
认证方式X-API-Key
接口提供官方接口

如何调用

  1. 注册/登录本站账号
  2. 前往用户中心 → API密钥 ,创建一个密钥
  3. 在请求头添加 X-API-Key 携带密钥即可调用
  4. 每次成功调用将扣除 0 积分
前往创建 API 密钥