开发文档
控制台 登录 注册

接口概述

请求方式
GET / POST
数据格式
JSON
字符编码
UTF-8
签名算法
无（使用 App ID + App Key 认证）
时间窗口
无时间戳要求

基础信息

API 地址
https://api.mcve.top/api/v2/
URL 格式
伪静态模式：/api/v2/{api_code}
原生模式：/api/v2/index.php?code={api_code}
认证方式
请求头或参数：X-APP-ID / app_id，X-APP-KEY / app_key

通用请求参数

参数名类型必填位置描述
app_idstring是Header/Body应用 ID
app_keystring是Header/Body应用 Key

通用错误码

错误码说明
0成功
1000请求参数错误
1001未提供认证信息
1002App ID 无效
1003App Key 错误
1004应用已禁用
1005未购买该 API
1006余额不足
1007请求频率超限
1008请求方法不允许
1009API 不存在
1010扣费失败
1011服务器内部错误
1012未完成实名认证
支付宝实名信息验证
支付宝官方实名信息比对（扫码/跳转授权）
请求地址
https://api.mcve.top/api/v2/alipaysm
请求参数
参数名类型必填描述
user_namestring是姓名
cert_nostring是身份证号
mobilestring否手机号
logon_idstring否支付宝登录账号
请求示例
## 发起认证 (action=start)
curl -X POST "https://api.mcve.top/api/v2/alipaysm?action=start" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"user_name":"张三","cert_no":"11010119900307663X"}'

## 查询认证结果 (action=result)
curl -X POST "https://api.mcve.top/api/v2/alipaysm?action=result" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"token":"your_token_here"}'
返回示例
## 发起认证响应 (action=start)
{
    "code": 0,
    "msg": "success",
    "data": {
        "token": "abc123def456",
        "verify_id": "verify_id_here",
        "auth_url": "https://openauth.alipay.com/oauth2/publicAppAuthorize.htm?app_id=xxx&scope=id_verify&redirect_uri=...&cert_verify_id=...&state=..."
    },
    "request_id": "req_xxx"
}

## 查询认证结果响应 (action=result)
{
    "code": 0,
    "msg": "success",
    "data": {
        "status": 2,
        "passed": "T",
        "fail_reason": null,
        "fail_params": null
    },
    "request_id": "req_xxx"
}
特定错误码
错误码说明
1200发起认证失败
1201查询认证结果失败
身份证二要素核验
核验姓名与身份证号是否一致，并返回性别、出生日期、地址等信息
请求地址
https://api.mcve.top/api/v2/idcard2check
请求参数
参数名类型必填描述
namestring是姓名
idcardstring是身份证号
请求示例
curl -X POST "https://api.mcve.top/api/v2/idcard2check" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"name":"张三","idcard":"11010119900307663X"}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "res": 1,
        "description": "一致",
        "name": "张三",
        "idcard": "340322199901011234"
    },
    "request_id": "req_67f0a1b2c3d4e"
}
特定错误码
错误码说明
1100核验失败（不一致或服务异常）
人脸实名认证
通过人脸识别比对姓名、身份证号是否一致
请求地址
https://api.mcve.top/api/v2/facecheck
请求参数
参数名类型必填描述
namestring是姓名
idcardstring是身份证号
file_urlstring是人脸照片URL地址
请求示例
curl -X POST "https://api.mcve.top/api/v2/facecheck" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"name":"张三","idcard":"11010119900307663X","file_url":"https://example.com/face.jpg"}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "score": 95,
        "verify": 1,
        "message": "系统判断为同一人"
    },
    "request_id": "req_67f0a1b2c3d4e"
}
特定错误码
错误码说明
1150人脸识别失败
手机号二要素核验
通过姓名+手机号进行运营商权威比对
请求地址
https://api.mcve.top/api/v2/phone2check
请求参数
参数名类型必填描述
namestring是姓名
phonestring是手机号
请求示例
curl -X POST "https://api.mcve.top/api/v2/phone2check" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"name":"张三","phone":"13800138000"}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "state": "1",
        "is_xhzw": "0",
        "old_yys": "移动",
        "new_yys": "移动"
    },
    "request_id": "req_67f0a1b2c3d4e"
}
特定错误码
错误码说明
1120手机号二要素核验失败
手机号三要素核验
通过姓名+手机号+身份证号进行运营商权威比对
请求地址
https://api.mcve.top/api/v2/phone3check
请求参数
参数名类型必填描述
namestring是姓名
phonestring是手机号
idcardstring是身份证号
请求示例
curl -X POST "https://api.mcve.top/api/v2/phone3check" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"name":"张三","phone":"13800138000","idcard":"11010119900307663X"}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "state": "1",
        "is_xhzw": "0",
        "old_yys": "移动",
        "new_yys": "移动"
    },
    "request_id": "req_67f0a1b2c3d4e"
}
特定错误码
错误码说明
1130手机号三要素核验失败
银行卡二三四要素验证
通过姓名+银行卡号进行银联权威验证
请求地址
https://api.mcve.top/api/v2/bankcard2check
请求参数
参数名类型必填描述
namestring是姓名
acct_nostring是银行卡号
idcardstring否身份证号
phonestring否手机号
请求示例
curl -X POST "https://api.mcve.top/api/v2/bankcard2check" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"name":"张三","acct_no":"6212261234567890"}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "state": "1"
    },
    "request_id": "req_67f0a1b2c3d4e"
}
特定错误码
错误码说明
1140银行卡验证失败
ICP域名备案查询
实时查询域名ICP备案信息（实时数据）
请求地址
https://api.mcve.top/api/v2/icpcx
请求参数
参数名类型必填描述
domainstring是域名（如：baidu.com）
请求示例
curl -X POST "https://api.mcve.top/api/v2/icpcx" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"domain":"baidu.com"}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "icp": "粤B2-20090059-5",
        "date": "2026-01-15 11:27:48",
        "name": "深圳市腾讯计算机系统有限公司",
        "type": "企业",
        "domain": "qq.com",
        "status": 1,
        "xianzhi": ""
    },
    "request_id": "req_67f0a1b2c3d4e"
}
特定错误码
错误码说明
1110ICP备案查询失败
WHOIS域名查询
查询域名的WHOIS信息（支持所有TLD）
请求地址
https://api.mcve.top/api/v2/whois
请求参数
参数名类型必填描述
domainstring是域名
请求示例
curl -X POST "https://api.mcve.top/api/v2/whois" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"domain":"baidu.com"}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "domain": "example.com",
        "result": "Domain Name: EXAMPLE.COM\nRegistry Domain ID: 123456_DOMAIN_COM-VRSN\nCreation Date: 1995-08-14T04:00:00Z\nExpiry Date: 2025-08-13T04:00:00Z\n..."
    },
    "request_id": "req_67f0a1b2c3d4e"
}
通用文字识别
通用文字识别
请求地址
https://api.mcve.top/api/v2/tyocr
请求参数
参数名类型必填描述
imagestring是图片URL或Base64编码
请求示例
curl -X POST "https://api.mcve.top/api/v2/tyocr" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"image":"图片URL或Base64"}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "log_id": 123456789,
        "words_result_num": 2,
        "words_result": [
            {
                "words": "你好世界"
            },
            {
                "words": "Hello World"
            }
        ]
    },
    "request_id": "req_67f0a1b2c3d4e"
}
特定错误码
错误码说明
1160无效的OCR类型
1161图片无效或下载失败
1162识别失败
手写字体识别
手写字体识别
请求地址
https://api.mcve.top/api/v2/sxocr
请求参数
参数名类型必填描述
imagestring是图片URL或Base64编码
请求示例
curl -X POST "https://api.mcve.top/api/v2/sxocr" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"image":"图片URL或Base64"}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "log_id": 123456789,
        "words_result_num": 1,
        "words_result": [
            {
                "words": "手写示例文字"
            }
        ]
    },
    "request_id": "req_67f0a1b2c3d4e"
}
特定错误码
错误码说明
1160无效的OCR类型
1161图片无效或下载失败
1162识别失败
身份证识别
身份证正面/反面识别
请求地址
https://api.mcve.top/api/v2/sfzocr
请求参数
参数名类型必填描述
imagestring是图片URL或Base64编码
sidestring是身份证面：front（正面）/back（反面）
请求示例
curl -X POST "https://api.mcve.top/api/v2/sfzocr" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"image":"图片URL或Base64","side":"front"}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "log_id": 123456789,
        "words_result_num": 9,
        "words_result": {
            "姓名": {
                "words": "张三"
            },
            "公民身份号码": {
                "words": "110101199001011234"
            },
            "住址": {
                "words": "北京市朝阳区"
            },
            "出生": {
                "words": "19900101"
            },
            "性别": {
                "words": "男"
            },
            "民族": {
                "words": "汉"
            },
            "签发日期": {
                "words": "20200101"
            },
            "失效日期": {
                "words": "20300101"
            },
            "签发机关": {
                "words": "北京市公安局"
            }
        },
        "image_status": "normal"
    },
    "request_id": "req_67f0a1b2c3d4e"
}
特定错误码
错误码说明
1160无效的OCR类型
1161图片无效或下载失败
1162识别失败
银行卡识别
银行卡号识别
请求地址
https://api.mcve.top/api/v2/yhocr
请求参数
参数名类型必填描述
imagestring是图片URL或Base64编码
请求示例
curl -X POST "https://api.mcve.top/api/v2/yhocr" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"image":"图片URL或Base64"}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "log_id": 123456789,
        "result": {
            "bank_card_number": "621226******1234",
            "bank_name": "工商银行"
        }
    },
    "request_id": "req_67f0a1b2c3d4e"
}
特定错误码
错误码说明
1160无效的OCR类型
1161图片无效或下载失败
1162识别失败
营业执照识别
营业执照识别
请求地址
https://api.mcve.top/api/v2/yyzzocr
请求参数
参数名类型必填描述
imagestring是图片URL或Base64编码
请求示例
curl -X POST "https://api.mcve.top/api/v2/yyzzocr" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"image":"图片URL或Base64"}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "log_id": 123456789,
        "words_result_num": 6,
        "words_result": {
            "单位名称": {
                "words": "某某科技有限公司"
            },
            "社会信用代码": {
                "words": "91110108MA01XXXXX"
            },
            "法人": {
                "words": "李四"
            },
            "地址": {
                "words": "北京市海淀区"
            },
            "注册资本": {
                "words": "100万元"
            },
            "成立日期": {
                "words": "2020年01月01日"
            }
        }
    },
    "request_id": "req_67f0a1b2c3d4e"
}
特定错误码
错误码说明
1160无效的OCR类型
1161图片无效或下载失败
1162识别失败
护照识别
护照信息识别
请求地址
https://api.mcve.top/api/v2/hzocr
请求参数
参数名类型必填描述
imagestring是图片URL或Base64编码
请求示例
curl -X POST "https://api.mcve.top/api/v2/hzocr" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"image":"图片URL或Base64"}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "log_id": 123456789,
        "words_result": {
            "姓名": {
                "words": "WANG XIAOMING"
            },
            "护照号码": {
                "words": "E12345678"
            },
            "国籍": {
                "words": "CHN"
            },
            "出生日期": {
                "words": "19900101"
            },
            "性别": {
                "words": "M"
            },
            "有效期至": {
                "words": "20300101"
            }
        }
    },
    "request_id": "req_67f0a1b2c3d4e"
}
特定错误码
错误码说明
1160无效的OCR类型
1161图片无效或下载失败
1162识别失败
出生证明识别
出生医学证明识别
请求地址
https://api.mcve.top/api/v2/csmzocr
请求参数
参数名类型必填描述
imagestring是图片URL或Base64编码
请求示例
curl -X POST "https://api.mcve.top/api/v2/csmzocr" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"image":"图片URL或Base64"}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "log_id": 123456789,
        "words_result": {
            "姓名": {
                "words": "张宝宝"
            },
            "性别": {
                "words": "男"
            },
            "出生日期": {
                "words": "2023-01-01"
            },
            "母亲姓名": {
                "words": "李华"
            },
            "父亲姓名": {
                "words": "张伟"
            },
            "医疗机构名称": {
                "words": "市妇幼保健院"
            }
        }
    },
    "request_id": "req_67f0a1b2c3d4e"
}
特定错误码
错误码说明
1160无效的OCR类型
1161图片无效或下载失败
1162识别失败
驾驶证识别
机动车驾驶证识别
请求地址
https://api.mcve.top/api/v2/jszocr
请求参数
参数名类型必填描述
imagestring是图片URL或Base64编码
请求示例
curl -X POST "https://api.mcve.top/api/v2/jszocr" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"image":"图片URL或Base64"}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "log_id": 123456789,
        "words_result": {
            "姓名": {
                "words": "王五"
            },
            "证号": {
                "words": "110101199001011234"
            },
            "准驾车型": {
                "words": "C1"
            },
            "有效起始日期": {
                "words": "20200101"
            },
            "有效截止日期": {
                "words": "20260101"
            }
        }
    },
    "request_id": "req_67f0a1b2c3d4e"
}
特定错误码
错误码说明
1160无效的OCR类型
1161图片无效或下载失败
1162识别失败
行驶证识别
机动车行驶证识别
请求地址
https://api.mcve.top/api/v2/xszocr
请求参数
参数名类型必填描述
imagestring是图片URL或Base64编码
请求示例
curl -X POST "https://api.mcve.top/api/v2/xszocr" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"image":"图片URL或Base64"}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "log_id": 123456789,
        "words_result": {
            "号牌号码": {
                "words": "京A12345"
            },
            "车辆类型": {
                "words": "小型轿车"
            },
            "所有人": {
                "words": "张三"
            },
            "使用性质": {
                "words": "非营运"
            },
            "品牌型号": {
                "words": "奥迪A6L"
            },
            "车辆识别代号": {
                "words": "LFV3A24F3J3000000"
            },
            "发动机号码": {
                "words": "123456"
            },
            "注册日期": {
                "words": "20200101"
            },
            "发证日期": {
                "words": "20200101"
            }
        }
    },
    "request_id": "req_67f0a1b2c3d4e"
}
特定错误码
错误码说明
1160无效的OCR类型
1161图片无效或下载失败
1162识别失败
车牌识别
车牌号码识别
请求地址
https://api.mcve.top/api/v2/cpocr
请求参数
参数名类型必填描述
imagestring是图片URL或Base64编码
请求示例
curl -X POST "https://api.mcve.top/api/v2/cpocr" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"image":"图片URL或Base64"}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "log_id": 123456789,
        "words_result": {
            "number": "京A12345",
            "color": "蓝"
        }
    },
    "request_id": "req_67f0a1b2c3d4e"
}
特定错误码
错误码说明
1160无效的OCR类型
1161图片无效或下载失败
1162识别失败
VIN码识别
车辆识别码（VIN）识别
请求地址
https://api.mcve.top/api/v2/vinocr
请求参数
参数名类型必填描述
imagestring是图片URL或Base64编码
请求示例
curl -X POST "https://api.mcve.top/api/v2/vinocr" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"image":"图片URL或Base64"}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "log_id": 123456789,
        "words_result": [
            {
                "words": "LFV3A24F3J3000000"
            }
        ]
    },
    "request_id": "req_67f0a1b2c3d4e"
}
特定错误码
错误码说明
1160无效的OCR类型
1161图片无效或下载失败
1162识别失败
通用票据识别
财务数据通用票据识别
请求地址
https://api.mcve.top/api/v2/pjocr
请求参数
参数名类型必填描述
imagestring是图片URL或Base64编码
请求示例
curl -X POST "https://api.mcve.top/api/v2/pjocr" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"image":"图片URL或Base64"}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "log_id": 123456789,
        "words_result_num": 3,
        "words_result": [
            {
                "words": "发票代码：1234567890"
            },
            {
                "words": "金额：100.00"
            },
            {
                "words": "开票日期：2025-01-01"
            }
        ]
    },
    "request_id": "req_67f0a1b2c3d4e"
}
特定错误码
错误码说明
1160无效的OCR类型
1161图片无效或下载失败
1162识别失败
增值税发票识别
增值税发票识别
请求地址
https://api.mcve.top/api/v2/fpocr
请求参数
参数名类型必填描述
imagestring是图片URL或Base64编码
请求示例
curl -X POST "https://api.mcve.top/api/v2/fpocr" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"image":"图片URL或Base64"}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "log_id": 123456789,
        "words_result": {
            "发票代码": {
                "words": "1234567890"
            },
            "发票号码": {
                "words": "12345678"
            },
            "开票日期": {
                "words": "2025-01-01"
            },
            "购方名称": {
                "words": "购买方公司"
            },
            "销方名称": {
                "words": "销售方公司"
            },
            "合计金额": {
                "words": "1000.00"
            },
            "合计税额": {
                "words": "130.00"
            },
            "价税合计": {
                "words": "1130.00"
            }
        }
    },
    "request_id": "req_67f0a1b2c3d4e"
}
特定错误码
错误码说明
1160无效的OCR类型
1161图片无效或下载失败
1162识别失败
出租车票识别
出租车票识别
请求地址
https://api.mcve.top/api/v2/czpocr
请求参数
参数名类型必填描述
imagestring是图片URL或Base64编码
请求示例
curl -X POST "https://api.mcve.top/api/v2/czpocr" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"image":"图片URL或Base64"}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "log_id": 123456789,
        "words_result": {
            "车牌号": {
                "words": "京B12345"
            },
            "日期": {
                "words": "2025-01-01"
            },
            "里程": {
                "words": "15.5"
            },
            "金额": {
                "words": "45.00"
            }
        }
    },
    "request_id": "req_67f0a1b2c3d4e"
}
特定错误码
错误码说明
1160无效的OCR类型
1161图片无效或下载失败
1162识别失败
定额发票识别
定额发票识别
请求地址
https://api.mcve.top/api/v2/defpocr
请求参数
参数名类型必填描述
imagestring是图片URL或Base64编码
请求示例
curl -X POST "https://api.mcve.top/api/v2/defpocr" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"image":"图片URL或Base64"}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "log_id": 123456789,
        "words_result": {
            "发票代码": {
                "words": "1234567890"
            },
            "发票号码": {
                "words": "12345678"
            },
            "金额": {
                "words": "100.00"
            }
        }
    },
    "request_id": "req_67f0a1b2c3d4e"
}
特定错误码
错误码说明
1160无效的OCR类型
1161图片无效或下载失败
1162识别失败
随机一言
随机返回一句诗句或日常一言
请求地址
https://api.mcve.top/api/v2/randomyy
请求参数
参数名类型必填描述
typestring否类型（random/comic/poetry等），默认随机
请求示例
curl -X POST "https://api.mcve.top/api/v2/randomyy" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"type":"random"}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "type": "random",
        "hitokoto": "愿你千山暮雪，海棠依旧。"
    },
    "request_id": "req_67f0a1b2c3d4e"
}
QQ头像查询API
通过QQ号获取昵称和头像，完全免费
请求地址
https://api.mcve.top/api/v2/qqinfo
请求参数
参数名类型必填描述
qqstring是QQ号
请求示例
curl -X GET "https://api.mcve.top/api/v2/qqinfo?qq=123456" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey"
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "qq": "123456789",
        "avatar": "https://qlogo4.store.qq.com/qzone/123456789/123456789/100"
    },
    "request_id": "req_67f0a1b2c3d4e"
}
身份证归属地查询
根据身份证号查询省、市、区县及详细地址
请求地址
https://api.mcve.top/api/v2/sfzgsd
请求参数
参数名类型必填描述
idcardstring是18位身份证号码
请求示例
curl -X POST "https://api.mcve.top/api/v2/idcard_location" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"idcard":"11010119900307663X"}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "province": "北京市",
        "city": "北京市",
        "district": "东城区",
        "address": "北京市东城区"
    },
    "request_id": "req_67f0a1b2c3d4e"
}
特定错误码
错误码说明
2000身份证号码格式错误
2001未查询到归属地信息
违禁词检测
检测文本中是否包含违禁词
请求地址
https://api.mcve.top/api/v2/wjcjc
请求参数
参数名类型必填描述
textstring是需要检测的文本内容
请求示例
curl -X POST "https://api.mcve.top/api/v2/wjcjc" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"text":"用户输入的文本内容"}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "has_banned": true,
        "banned_words": [
            "敏感词1",
            "敏感词2"
        ],
        "message": "文本包含违禁词"
    },
    "request_id": "req_xxx"
}
特定错误码
错误码说明
3000文本参数不能为空
3001词库加载失败
单位换算器
支持长度、面积、体积、质量、温度、压力、功率、能量、速度、时间等物理量的单位换算
请求地址
https://api.mcve.top/api/v2/dwhsq
请求参数
参数名类型必填描述
valuenumber是数值，支持浮点数
from_unitstring是源单位。支持的单位：长度（米、千米、分米、厘米、毫米、英里、码、英尺、英寸、海里、光年、天文单位），面积（平方米、平方千米、平方分米、平方厘米、平方毫米、公顷、亩、英亩、平方英里、平方英尺），体积（立方米、立方分米、立方厘米、升、毫升、加仑(美)、加仑(英)、立方英尺、立方英寸），质量（千克、克、毫克、吨、磅、盎司、斤、两），温度（摄氏度、华氏度、开尔文），压力（帕斯卡、千帕、兆帕、巴、标准大气压、毫米汞柱、磅力/平方英寸），功率（瓦特、千瓦、兆瓦、马力、英尺·磅/秒、卡路里/秒），能量（焦耳、千焦、兆焦、卡路里、千卡、千瓦时、电子伏特），速度（米/秒、千米/小时、英里/小时、节、马赫），时间（秒、毫秒、微秒、分钟、小时、天、周、年）
to_unitstring是目标单位（单位列表与 from_unit 相同）
categorystring是物理量类别，可选值：length（长度）、area（面积）、volume（体积）、mass（质量）、temperature（温度）、pressure（压力）、power（功率）、energy（能量）、speed（速度）、time（时间）
请求示例
curl -X POST "https://api.mcve.top/api/v2/dwhsq" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"category":"length","value":1,"from_unit":"米","to_unit":"英尺"}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "category": "length",
        "from_value": 1,
        "from_unit": "米",
        "to_unit": "英尺",
        "result": 3.280839895013123,
        "formatted": "1 米 = 3.2808 英尺"
    },
    "request_id": "req_xxx"
}
特定错误码
错误码说明
5000不支持的类别
5001不支持的源单位
5002不支持的目标单位
5003数值无效
条形码生成
根据文本内容生成CODE128条形码（支持数字、字母、特殊符号）
请求地址
https://api.mcve.top/api/v2/txmsc
请求参数
参数名类型必填描述
textstring是要编码的内容（建议不超过50字符）
widthint否图片宽度（像素），默认200
heightint否图片高度（像素），默认80
请求示例
curl -X POST "https://api.mcve.top/api/v2/txmsc" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"text":"1234567890","width":200,"height":80}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUg...",
        "text": "1234567890",
        "format": "CODE128",
        "width": 200,
        "height": 80
    },
    "request_id": "req_xxx"
}
特定错误码
错误码说明
5100文本内容不能为空
5101文本过长无法编码
条形码识别
识别图片中的条形码（支持CODE128/EAN13/CODE39/UPC等常见格式）
请求地址
https://api.mcve.top/api/v2/txmsb
请求参数
参数名类型必填描述
image_urlstring是条形码图片的URL地址（支持http/https）
请求示例
curl -X POST "https://api.mcve.top/api/v2/txmsb" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"image_url":"https://example.com/barcode.png"}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "decoded_text": "6901234567890",
        "format": "EAN13",
        "confidence": 0.99
    },
    "request_id": "req_xxx"
}
特定错误码
错误码说明
5200图片URL不能为空
5201图片下载失败
5202未检测到条形码
5203条形码解码失败
二维码生成
根据文本生成二维码图片（支持URL、文本、名片等）
请求地址
https://api.mcve.top/api/v2/ewmsc
请求参数
参数名类型必填描述
textstring是要编码的文本内容
sizeint否二维码图片尺寸（像素），默认200
marginint否白边宽度（像素），默认2
请求示例
curl -X POST "https://api.mcve.top/api/v2/ewmsc" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"text":"https://api.mcve.top","size":200}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
        "text": "https://api.mcve.top",
        "size": 200
    },
    "request_id": "req_xxx"
}
特定错误码
错误码说明
5300文本内容不能为空
二维码识别
识别图片中的二维码，返回解码后的文本内容
请求地址
https://api.mcve.top/api/v2/ewmsb
请求参数
参数名类型必填描述
image_urlstring是二维码图片的URL地址
请求示例
curl -X POST "https://api.mcve.top/api/v2/ewmsb" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"image_url":"https://example.com/qrcode.png"}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "decoded_text": "https://api.mcve.top",
        "size": 200
    },
    "request_id": "req_xxx"
}
特定错误码
错误码说明
5400图片URL不能为空
5401图片下载失败
5402未检测到二维码
5403二维码解码失败
生肖查询
根据年份（1900-2100）查询对应的中国生肖及五行属性
请求地址
https://api.mcve.top/api/v2/sx
请求参数
参数名类型必填描述
yearint是年份（1900~2100）
请求示例
curl -X POST "https://api.mcve.top/api/v2/sx" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"year":2026}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "year": 2026,
        "zodiac": "马",
        "element": "火",
        "stems_branches": "丙午"
    },
    "request_id": "req_xxx"
}
特定错误码
错误码说明
5600年份超出范围（1900-2100）
图形验证码生成
生成带干扰的图片验证码（支持数字、小写字母、大写字母、汉字混合），返回Base64图片及验证码Token
请求地址
https://api.mcve.top/api/v2/txyzm
请求参数
参数名类型必填描述
lengthint否验证码字符个数，默认4，支持1-6
typestring否字符类型：number（纯数字），letter（纯字母），mixed（数字+字母），chinese（纯汉字），all（数字+字母+汉字），默认mixed
widthint否图片宽度（像素），默认150
heightint否图片高度（像素），默认50
请求示例
curl -X POST "https://api.mcve.top/api/v2/txyzm" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"length":4,"type":"mixed","width":150,"height":50}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "captcha_token": "c5e2f7a9b8d1e3f6h4j2",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
        "expires_in": 300
    },
    "request_id": "req_xxx"
}
特定错误码
错误码说明
5700参数无效
货币汇率查询
查询实时汇率（支持人民币、美元、欧元、英镑、日元等100+种货币）
请求地址
https://api.mcve.top/api/v2/hl
请求参数
参数名类型必填描述
from_currencystring是源货币代码（如CNY/USD/EUR）
to_currencystring是目标货币代码
请求示例
curl -X POST "https://api.mcve.top/api/v2/hl" \
  -H "Content-Type: application/json" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d '{"from_currency":"CNY","to_currency":"USD"}'
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "base": "CNY",
        "target": "USD",
        "rate": 0.1382,
        "timestamp": 1698765432,
        "formatted": "1 人民币 = 0.1382 美元"
    },
    "request_id": "req_xxx"
}
特定错误码
错误码说明
5800不支持的货币代码
验证码短信
发送验证码短信，使用共享签名“枕梦听河”和共享验证码模板。
请求地址
https://api.mcve.top/api/v2/sms
请求参数
参数名类型必填描述
phonestring是接收验证码的手机号，11位数字
codestring是验证码内容（数字或字母组合，建议4-6位）
timestring否验证码有效分钟数，默认5，范围1~30
请求示例
curl -X POST "https://api.mcve.top/api/v2/sms" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -H "X-APP-ID: 你的AppID" \
  -H "X-APP-KEY: 你的AppKey" \
  -d "phone=13800138000&code=123456&time=5"
返回示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "biz_id": "123456789012345678"
    },
    "request_id": "req_67f0a1b2c3d4e"
}