三要素身份核验API文档

接口概述

三要素身份核验API通过姓名、身份证号、手机号三要素进行实时身份验证，确保用户身份的真实性和一致性。

该接口广泛应用于金融、电商、共享经济等对安全性要求高的场景，能够有效防范欺诈行为，提升业务安全性。

接口特性

实时验证：平均响应时间低于200ms
高准确率：验证准确率高达99.7%
银行级安全：数据传输全程加密
高可用性：99.9%服务可用性保障

接口地址

HTTP 请求端点

POST https://api.ouovo.cc/sys.php

注意：请勿频繁请求，导致被系统拉黑

请求参数

参数名	类型	是否必填	说明
name	String	是	真实姓名，需与身份证信息一致
sfz	String	是	身份证号码，18位标准身份证号
sjh	String	是	手机号码，11位有效手机号

调用方式

请求示例

HTTP 请求示例

POST sys.php HTTP/1.1
Host: api.ouovo.cc
Content-Type: application/json
User-Agent: Your-Application-Name

{
    "name": "张三",
    "sfz": "110101199001011234",
    "sjh": "13800138000"
}

注意事项

所有请求必须使用POST方法
Content-Type必须设置为application/json
参数必须完整，缺少任一参数将返回400错误
建议设置合理的请求超时时间（建议30秒）

代码示例

PHP 调用示例

<?php
// 三要素身份核验API调用示例
$api_url = "https://api.ouovo.cc/sys.php";

// 请求参数
$data = [
    "name" => "张三",
    "sfz"  => "110101199001011234",
    "sjh"  => "13800138000"
];

// 初始化cURL
$ch = curl_init($api_url);

// 设置cURL选项
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => json_encode($data, JSON_UNESCAPED_UNICODE),
    CURLOPT_HTTPHEADER     => [
        "Content-Type: application/json",
        "User-Agent: Your-Application-Name"
    ],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
    CURLOPT_SSL_VERIFYPEER => false
]);

// 执行请求
$response = curl_exec($ch);

if ($response === false) {
    $error = curl_error($ch);
    echo "请求失败: " . $error;
} else {
    $result = json_decode($response, true);
    echo "响应结果:\n";
    print_r($result);
}

curl_close($ch);
?>

Python 调用示例

import requests
import json

# API地址
api_url = "https://api.ouovo.cc/sys.php"

# 请求参数
data = {
    "name": "张三",
    "sfz": "110101199001011234",
    "sjh": "13800138000"
}

# 设置请求头
headers = {
    "Content-Type": "application/json",
    "User-Agent": "Your-Application-Name"
}

try:
    # 发送POST请求
    response = requests.post(
        api_url,
        data=json.dumps(data, ensure_ascii=False).encode('utf-8'),
        headers=headers,
        timeout=30
    )
    
    # 解析响应
    result = response.json()
    print("响应结果:")
    print(json.dumps(result, indent=2, ensure_ascii=False))
    
except requests.exceptions.RequestException as e:
    print(f"请求失败: {e}")
except json.JSONDecodeError as e:
    print(f"JSON解析失败: {e}")

Node.js 调用示例

const https = require('https');

// API地址
const apiUrl = 'https://api.ouovo.cc/sys.php';

// 请求参数
const data = JSON.stringify({
    name: "张三",
    sfz: "110101199001011234",
    sjh: "13800138000"
});

// 请求选项
const options = {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'Content-Length': Buffer.byteLength(data),
        'User-Agent': 'Your-Application-Name'
    },
    timeout: 30000
};

// 发送请求
const req = https.request(apiUrl, options, (res) => {
    let responseData = '';
    
    res.on('data', (chunk) => {
        responseData += chunk;
    });
    
    res.on('end', () => {
        try {
            const result = JSON.parse(responseData);
            console.log('响应结果:');
            console.log(JSON.stringify(result, null, 2));
        } catch (error) {
            console.error('JSON解析失败:', error);
        }
    });
});

req.on('error', (error) => {
    console.error('请求失败:', error);
});

req.on('timeout', () => {
    console.error('请求超时');
    req.destroy();
});

// 发送数据
req.write(data);
req.end();

返回结果

成功响应示例

{
    "code": 520,
    "msg": "核验成功"
}

失败响应示例

{
    "code": 250,
    "msg": "核验失败"
}

参数错误响应示例

{
    "code": 400,
    "msg": "参数不完整"
}

错误码说明

错误码	说明	解决方案
520	核验成功	身份信息验证通过
250	核验失败	身份信息不匹配或不存在
400	参数不完整	检查请求参数是否完整
500	服务器内部错误	联系技术支持或稍后重试

常见问题

Q: 接口支持哪些参数？

A: 接口支持三个必填参数：name（姓名）、sfz（身份证号）、sjh（手机号）。所有参数必须完整提供。

Q: 接口响应时间是多少？

A: 接口平均响应时间低于200ms，支持高并发请求，满足各种业务场景需求。

Q: 接口调用有频率限制吗？

A: 是的，接口支持最高1000次/秒的查询频率限制。如有更高需求，请联系商务合作。

Q: 如何获取API密钥？

A: 请通过Telegram商务合作渠道联系我们，获取专属的API密钥和接入权限。

三要素身份核验 API 文档

文档目录