多平台统一接入
屏蔽各家服务商签名、字段、返回格式差异，对外输出标准 API。
企业级实名认证 API 聚合平台
幻影聚合实名认证
统一接入多家实名服务商的实名认证 API 聚合管理平台
基于 ThinkPHP8.1 开发，统一封装多家实名接口，屏蔽服务商签名、字段和返回差异，提供标准化 API、套餐额度、API Key 权限和调用日志，帮助企业快速搭建实名核验能力。
1 个在线接口1 个可用套餐2 个标准字段
POST /api/v1/verify200 OK
ResponseJSON128ms
{
"request_id": "req_202608190001",
"code": "SUCCESS",
"data": {
"verified": true,
"result_code": "MATCH",
"status": "PASSED"
}
}✓统一结果已返回request_id 可追踪
↗多平台统一服务商差异由插件处理
WHY PHANTOM
为真实业务准备的统一能力
从接入、配置、调用到结果追踪，一套后台完成全链路管理。
插件化扩展
新增服务商只需部署插件，无需改动核心业务逻辑，平台能力持续扩展。
同步 / 异步双模式
支持实时核验、人脸 H5 异步核身，自动轮询获取最终结果。
套餐额度管理
灵活创建套餐，管控调用次数、有效期和续费管理，额度明细清晰。
API Key 精细权限
支持多密钥、IP 白名单、接口权限和调用限流，控制每一次访问。
全链路调用日志
完整记录请求、扣次、回调和服务商响应，让每一笔数据都可追溯。
PROVIDER READY
兼容多家实名服务商
服务商适配通过插件完成，按需部署，持续扩展新增平台。
腾讯云人脸核身 / 实名核验
华为云二要素 / 三要素
数脉 API身份与运营商核验
幻影 API统一插件能力
API CAPABILITIES
丰富的实名认证接口能力
统一接口编码和字段 Schema，个人认证优先覆盖，企业认证预留扩展。
统一结果结构同步返回或认证 URL 均使用统一状态值。
DOCS
接口文档
公开列出当前已发布接口的调用方式、参数字段、状态值和异步查询规则。详细套餐权限请登录用户中心查看。
01
接口概览
所有业务实名认证请求使用 API Key 认证，并通过统一接口编码和套餐编码匹配平台配置。
请求方式POST
请求地址
/api/v1/verifications查询地址
GET /api/v1/verifications/:id内容类型application/json
认证 Header
Authorization: Bearer YOUR_API_KEYIdempotency-Key: unique_request_key02
请求参数
公共参数用于确定接口和幂等请求，业务参数按照已发布接口的字段 Schema 传入。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
interface_code | string | 是 | 已发布的统一接口编码 |
plan_code | string | 是 | 用户已开通的套餐编码 |
customer_request_id | string | 否 | 调用方业务订单或请求编号 |
data | object | 是 | 由接口 Schema 定义的认证字段 |
03
返回结构
统一返回 request_id、verification_id、status、result_code 和额度结算信息，服务商原始差异不会直接暴露给调用方。
request_id本次请求追踪编号verification_id认证任务编号status认证任务状态result_code标准结果编码04
状态值与异步查询
SUCCESS认证完成并返回明确结果。
PROCESSING认证处理中，使用 verification_id 查询。
FAILED认证失败或服务商返回不可用。
EXPIRED认证链接、任务或有效时间已过期。
SYSTEM_ERROR系统处理异常，建议记录 request_id 后重试或联系管理员。
异步流程提交请求 → 获取认证 URL / verification_id → 用户完成核身 → 轮询 GET 查询接口 → 读取最终状态。
05
已发布接口字段
以下内容来自当前后台已发布的统一接口配置，不自动创建接口或套餐。
个人业务实名认证：腾讯云微信 H5 人脸核身PERSON_BUSINESS_TENCENT_FACE_H5ASYNC
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
name | text | 是 | 姓名 |
id_number | text | 是 | 身份证号 |
PRICING CONTROL
灵活套餐管理
套餐价格、调用次数和有效期都可以在后台自定义，注册后查看完整目录。
PACKAGE 01
个人认证基础套餐
个人业务实名认证：腾讯云微信 H5 人脸核身
￥18.00/ 1 次调用查看并开通USE CASES
适配需要可信身份的业务场景
统一 API 让不同业务线可以复用同一套实名核验能力。
SaaS 平台实名核验
为租户提供可配置的身份校验能力。
电商与租赁身份校验
在下单、签约、交付环节核验身份。
游戏与社区实名认证
按业务需要接入个人实名与人脸能力。
企业内部权限核验
为高敏感操作增加可信身份确认。
下游 API 分销平台
用统一密钥、额度和日志管理分发调用。
QUICK START
一行代码快速接入
统一请求、统一结果、统一 request_id。登录用户中心查看完整接口文档。
{
"interface_code": "PERSON_BUSINESS",
"plan_code": "STANDARD_100",
"data": {
"name": "张三",
"id_number": "110101199001011234"
}
}{
"request_id": "req_202608190001",
"code": "SUCCESS",
"data": {
"verified": true,
"result_code": "MATCH",
"status": "PASSED"
}
}FAQ
常见问题
关于服务商接入、异步核身、额度和企业认证的常见说明。
是否需要分别对接腾讯云、华为云等平台？
不需要。调用方只需要对接幻影聚合系统的统一 API；服务商签名、字段和返回转换由系统内的实名插件处理。
新增一个实名服务商需要修改核心代码吗？
通常不需要。按照插件接口实现服务商适配器，补充插件清单和字段 Schema，部署插件后即可在后台配置和发布。
人脸或刷脸接口如何返回结果？
系统先返回认证 URL 和认证 ID。用户完成认证后，系统通过轮询查询服务商结果，调用方可以主动查询，也可以配置 HTTPS 回调接收最终结果。
业务调用失败会扣除次数吗？
系统使用额度预占、扣除和释放机制。根据统一结果和服务商状态结算额度，服务商不可用或请求未成功时按系统规则释放预占额度。
是否支持企业认证？
系统的数据结构和接口类型已经为企业认证预留扩展能力。企业认证插件和对应服务商接口需要根据实际采购的企业认证产品继续接入，不能与个人认证接口混用。
PRIVATE DEPLOYMENT
查看部署文档 快速私有化部署
运行环境 PHP 8.1+、ThinkPHP 8.1、MySQL，向导式一键安装，数据和调用日志由你掌控。