接口概述
请求方式
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_id | string | 是 | Header/Body | 应用 ID |
| app_key | string | 是 | Header/Body | 应用 Key |
通用错误码
| 错误码 | 说明 |
|---|---|
| 0 | 成功 |
| 1000 | 请求参数错误 |
| 1001 | 未提供认证信息 |
| 1002 | App ID 无效 |
| 1003 | App Key 错误 |
| 1004 | 应用已禁用 |
| 1005 | 未购买该 API |
| 1006 | 余额不足 |
| 1007 | 请求频率超限 |
| 1008 | 请求方法不允许 |
| 1009 | API 不存在 |
| 1010 | 扣费失败 |
| 1011 | 服务器内部错误 |
| 1012 | 未完成实名认证 |
支付宝实名信息验证
支付宝官方实名信息比对(扫码/跳转授权)
请求地址
https://api.mcve.top/api/v2/alipaysm
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| user_name | string | 是 | 姓名 |
| cert_no | string | 是 | 身份证号 |
| mobile | string | 否 | 手机号 |
| logon_id | string | 否 | 支付宝登录账号 |
请求示例
## 发起认证 (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
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| name | string | 是 | 姓名 |
| idcard | string | 是 | 身份证号 |
请求示例
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
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| name | string | 是 | 姓名 |
| idcard | string | 是 | 身份证号 |
| file_url | string | 是 | 人脸照片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
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| name | string | 是 | 姓名 |
| phone | string | 是 | 手机号 |
请求示例
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
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| name | string | 是 | 姓名 |
| phone | string | 是 | 手机号 |
| idcard | string | 是 | 身份证号 |
请求示例
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
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| name | string | 是 | 姓名 |
| acct_no | string | 是 | 银行卡号 |
| idcard | string | 否 | 身份证号 |
| phone | string | 否 | 手机号 |
请求示例
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
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| domain | string | 是 | 域名(如: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"
}特定错误码
| 错误码 | 说明 |
|---|---|
| 1110 | ICP备案查询失败 |
WHOIS域名查询
查询域名的WHOIS信息(支持所有TLD)
请求地址
https://api.mcve.top/api/v2/whois
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| domain | string | 是 | 域名 |
请求示例
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
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| image | string | 是 | 图片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
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| image | string | 是 | 图片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
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| image | string | 是 | 图片URL或Base64编码 |
| side | string | 是 | 身份证面: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
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| image | string | 是 | 图片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
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| image | string | 是 | 图片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
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| image | string | 是 | 图片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
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| image | string | 是 | 图片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
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| image | string | 是 | 图片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
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| image | string | 是 | 图片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
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| image | string | 是 | 图片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
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| image | string | 是 | 图片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
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| image | string | 是 | 图片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
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| image | string | 是 | 图片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
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| image | string | 是 | 图片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
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| image | string | 是 | 图片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
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| type | string | 否 | 类型(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
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| string | 是 | 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"
}邮件发送API
通过SMTP发送邮件,支持HTML,需自备SMTP账号
请求地址
https://api.mcve.top/api/v2/emailfs
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| to | string | 是 | 收件人邮箱 |
| from_email | string | 是 | 发件人邮箱 |
| from_name | string | 是 | 发件人名称 |
| smtp_host | string | 是 | SMTP服务器 |
| smtp_port | int | 是 | SMTP端口 |
| smtp_user | string | 是 | SMTP用户名 |
| smtp_pass | string | 是 | SMTP密码 |
| subject | string | 是 | 邮件主题 |
| body | string | 是 | 邮件内容 |
| is_html | boolean | 否 | 是否HTML格式 |
请求示例
curl -X POST "https://api.mcve.top/api/v2/emailfs" \
-H "Content-Type: application/json" \
-H "X-APP-ID: 你的AppID" \
-H "X-APP-KEY: 你的AppKey" \
-d '{"to":"test@example.com","from_email":"sender@example.com","from_name":"发送者","smtp_host":"smtp.example.com","smtp_port":465,"smtp_user":"user","smtp_pass":"pass","subject":"测试","body":"内容"}'返回示例
{
"code": 0,
"msg": "success",
"data": {
"message": "邮件已发送"
},
"request_id": "req_67f0a1b2c3d4e"
}