零信任架构实战：基于天远运营商三要素简版V即时版查询构建自动化首诊患者实名建档网关-平芜编程栈

破解互联网医疗首诊建档痛点：从患者人工上传证照核对到运营商实名数据直连

在垂直医疗健康问诊平台的日常运营中，互联网首诊患者的实名建档与电子健康档案（EHR）合规管理是诊疗链路的核心前提。根据互联网诊疗监管规范，平台在为患者开通图文问诊、视频复诊以及流转电子处方前，必须确保就诊人姓名、公民身份号码与当前绑定的联系手机号处于真实、一致的实名登记状态，以保障处方用药安全、医保结算合规以及诊后随访触达的准确性。在传统的 PHP 医疗门户架构中，往往依赖患者手动填写资料并上传手持证件照片，再由后台导诊或药师团队人工比对。这种方式不仅在就诊高峰期容易造成审方排队积压，而且无法实时核验患者所填手机号是否为本人实名在用号码，一旦出现亲属代填混淆或录入笔误，极易引发诊后用药指导短信错发及电子病历归档偏差。

为了在不打断患者挂号问诊体验的前提下完成高可靠性的身份确认，技术团队可以在 PHP 问诊建档网关中接入运营商三要素简版V即时版查询接口。在获得患者签署的《互联网诊疗知情同意与实名核验授权书》后，系统只需提取前端提交的name（就诊人姓名）、id_card（身份证号）与mobile_no（联系手机号），通过 AES-128-CBC 加密隧道直连权威核验通道。接口在毫秒级内即可解密返回核心校验结果字段result（0代表三要素一致、1代表不一致、2代表库中无记录）与desc结果描述，同时一并返回手机号归属的channel运营商通道标识（cmcc移动、cucc联通、ctcc电信、gdcc广电）以及经解析提取的sex（性别）、birthday（生日）与address（籍贯）信息。这些结构化响应字段不仅能直接作为首诊实名建档的客观准入依据，还能辅助电子病历系统自动校准患者周岁年龄与生理性别，避免儿科、妇产科或老年慢病科室在分诊及处方剂量计算时出现基础信息错配。

将该核验能力封装为 PHP 医疗中台的标准化前置微服务后，问诊平台即可实现从“事后人工抽检审方”向“诊前自动化合规审查”的架构演进。对于核验一致的就诊请求，系统无感完成实名档案激活并自动进入分诊队列；对于存在要素偏差的请求，则实时触发前端纠错提示或引导进入家属代办绑定流程，从而在保障医疗数据合规流转的同时显著提升首诊接待效率。

PHP 加密通信集成：构建高可用审核管道

1. 核心参数与加密配置

接口地址:https://api.tianyuanapi.com/api/v1/YYSYH6F3(需在 URL 附加?t=13位时间戳)
请求方式:POST
请求头:
- Access-Id: 账号的 Access-Id (必填)
- Content-Type:application/json
关键入参:
- mobile_no: 就诊患者实名认证手机号，字符串类型（必填）
- id_card: 就诊患者公民身份号码，字符串类型（必填）
- name: 就诊患者真实姓名，字符串类型（必填）
鉴权与加密机制: 使用账户的 16 进制 Access Key 作为密钥，采用 AES-128 算法的 CBC 模式。每次请求需动态生成 16 字节的 IV（初始化向量），并配合 PKCS7 填充，最终将 IV 与密文拼接后进行 Base64 编码放入请求体data字段中。

2. 标准化调用代码 (PHP)

以下提供基于 PHP 8.x 编写的垂直医疗健康问诊平台首诊实名建档核验服务类。代码完整实现了 16 进制密钥转换、每次请求动态生成 16 字节随机 IV、AES-128-CBC 加解密（OpenSSL 默认启用 PKCS7 填充）、cURL 超时控制以及针对患者档案初始化的业务分流逻辑：

<?phpdeclare(strict_types=1);namespaceMedicalPortal\Compliance;useRuntimeException;useInvalidArgumentException;/** * 垂直医疗健康问诊平台 - 互联网首诊患者实名建档核验客户端 * 对接接口：运营商三要素简版V即时版查询 (YYSYH6F3) */classPatientRealNameVerifyService{privateconstAPI_ENDPOINT='https://api.tianyuanapi.com/api/v1/YYSYH6F3';privateconstCIPHER_ALGO='AES-128-CBC';privatestring$accessId;privatestring$binaryKey;privateint$timeoutSeconds;/** * @param string $accessId 账号分配的 Access-Id * @param string $hexAccessKey 账号分配的 16 进制 Access Key (32个十六进制字符，对应16字节) * @param int $timeoutSeconds HTTP 请求超时时间（秒） */publicfunction__construct(string$accessId,string$hexAccessKey,int$timeoutSeconds=5){$cleanHex=trim($hexAccessKey);if(strlen($cleanHex)!==32||!ctype_xdigit($cleanHex)){thrownewInvalidArgumentException('Access Key 必须为 32 位合法的 16 进制字符串（128 位密钥）。');}$binaryKey=hex2bin($cleanHex);if($binaryKey===false||strlen($binaryKey)!==16){thrownewInvalidArgumentException('Access Key 转换为二进制密钥失败。');}$this->accessId=trim($accessId);$this->binaryKey=$binaryKey;$this->timeoutSeconds=$timeoutSeconds;}/** * AES-128-CBC 加密：动态生成 16 字节 IV，PKCS7 填充，拼接 IV + 密文后进行 Base64 编码 */privatefunctionencryptPayload(array$payload):string{$plainJson=json_encode($payload,JSON_UNESCAPED_UNICODE|JSON_THROW_ON_ERROR);$iv=random_bytes(16);$cipherText=openssl_encrypt($plainJson,self::CIPHER_ALGO,$this->binaryKey,OPENSSL_RAW_DATA,$iv);if($cipherText===false){thrownewRuntimeException('请求报文 AES-128-CBC 加密失败: '.openssl_error_string());}returnbase64_encode($iv.$cipherText);}/** * AES-128-CBC 解密：Base64 解码后截取前 16 字节作为 IV，解密剩余密文并去除 PKCS7 填充 */privatefunctiondecryptPayload(string$base64Data):array{$rawBytes=base64_decode($base64Data,true);if($rawBytes===false||strlen($rawBytes)<=16){thrownewRuntimeException('响应密文格式异常，无法提取有效的 16 字节 IV。');}$iv=substr($rawBytes,0,16);$cipherText=substr($rawBytes,16);$decryptedJson=openssl_decrypt($cipherText,self::CIPHER_ALGO,$this->binaryKey,OPENSSL_RAW_DATA,$iv);if($decryptedJson===false){thrownewRuntimeException('响应报文 AES-128-CBC 解密失败: '.openssl_error_string());}$result=json_decode($decryptedJson,true,512,JSON_THROW_ON_ERROR);returnis_array($result)?$result:[];}/** * 执行首诊患者实名三要素核验并生成建档建议 * * @param string $patientName 就诊人姓名 * @param string $idCardNumber 就诊人身份证号 * @param string $mobileNumber 就诊人联系手机号 * @return array 包含核验结果与电子病历建档元数据的结构化数组 */publicfunctionverifyPatientForArchive(string$patientName,string$idCardNumber,string$mobileNumber):array{$requestData=['name'=>trim($patientName),'id_card'=>strtoupper(trim($idCardNumber)),'mobile_no'=>trim($mobileNumber),];$encryptedData=$this->encryptPayload($requestData);// 构造 13 位毫秒级时间戳参数$timestampMs=(int)round(microtime(true)*1000);$requestUrl=sprintf('%s?t=%d',self::API_ENDPOINT,$timestampMs);$requestBody=json_encode(['data'=>$encryptedData],JSON_THROW_ON_ERROR);$ch=curl_init($requestUrl);curl_setopt_array($ch,[CURLOPT_POST=>true,CURLOPT_POSTFIELDS=>$requestBody,CURLOPT_RETURNTRANSFER=>true,CURLOPT_TIMEOUT=>$this->timeoutSeconds,CURLOPT_CONNECTTIMEOUT=>3,CURLOPT_HTTPHEADER=>['Content-Type: application/json','Access-Id: '.$this->accessId,],]);$rawResponse=curl_exec($ch);$httpStatus=(int)curl_getinfo($ch,CURLINFO_HTTP_CODE);$curlError=curl_error($ch);curl_close($ch);if($rawResponse===false){thrownewRuntimeException(sprintf('问诊实名核验网关网络通信异常: %s',$curlError));}if($httpStatus!==200){thrownewRuntimeException(sprintf('问诊实名核验网关 HTTP 状态码异常: %d',$httpStatus));}$outerResponse=json_decode($rawResponse,true,512,JSON_THROW_ON_ERROR);// 校验外层公共状态码与加密数据字段if(($outerResponse['code']??-1)!==0||empty($outerResponse['data'])){return['archive_allowed'=>false,'action_route'=>'MANUAL_REVIEW_QUEUE','transaction_id'=>$outerResponse['transaction_id']??'','reason'=>sprintf('上游通道响应状态说明: [%s] %s',(string)($outerResponse['code']??''),$outerResponse['message']??'未知状态'),];}$bizData=$this->decryptPayload((string)$outerResponse['data']);$verifyResult=(string)($bizData['result']??'');// 根据 result 状态码映射互联网医院首诊建档动作$archiveAllowed=($verifyResult==='0');$actionRoute=match($verifyResult){'0'=>'AUTO_ACTIVATE_EMR',// 三要素一致，自动激活电子健康档案并放行问诊'1'=>'REDIRECT_GUARDIAN_BINDING',// 要素不一致，提示核对输入或转入亲属监护人代绑流程'2'=>'SUPPLEMENTARY_VERIFICATION',// 无记录（如新入网号卡），引导补充实名凭证人工复核default=>'MANUAL_REVIEW_QUEUE',};return['archive_allowed'=>$archiveAllowed,'action_route'=>$actionRoute,'transaction_id'=>$outerResponse['transaction_id']??'','order_no'=>$bizData['order_no']??'','result_code'=>$verifyResult,'result_desc'=>$bizData['desc']??'','carrier_channel'=>$bizData['channel']??'','patient_profile'=>['sex'=>$bizData['sex']??'','birthday'=>$bizData['birthday']??'','address'=>$bizData['address']??'',],];}}// ============================================================================// 生产网关调用演示（从环境变量加载密钥，严禁硬编码）// ============================================================================if(PHP_SAPI==='cli'&&basename(__FILE__)===basename($_SERVER['SCRIPT_FILENAME'])){$accessId=getenv('TIANYUAN_ACCESS_ID')?:'your_access_id_here';$accessKey=getenv('TIANYUAN_ACCESS_KEY')?:'0123456789abcdef0123456789abcdef';try{$verifier=newPatientRealNameVerifyService($accessId,$accessKey);$decision=$verifier->verifyPatientForArchive('张晓明','11010119900307251X','13800138000');// 脱敏输出日志，保护患者个人隐私信息 (PII)echo"[首诊建档核验完成] 流水号: ".$decision['transaction_id'].PHP_EOL;echo"[核验订单号] ".$decision['order_no']." | 路由策略: ".$decision['action_route'].PHP_EOL;echo"[档案基础画像] 性别: ".$decision['patient_profile']['sex']." | 出生日期: ".$decision['patient_profile']['birthday']." | 运营商通道: ".$decision['carrier_channel'].PHP_EOL;}catch(\Throwable$e){error_log('[首诊建档核验异常] '.$e->getMessage());}}

3. 终端快捷验证 (cURL)

在医院内网联调或容器环境排障时，研发人员可先利用openssl生成加密的data负载，再通过以下cURL命令快速验证网关连通性：

# 将 13位毫秒时间戳附加至 URL，并携带加密后的 Base64 字符串发起请求curl-XPOST"https://api.tianyuanapi.com/api/v1/YYSYH6F3?t=$(date+%s)000"\-H"Content-Type: application/json"\-H"Access-Id: YOUR_ACCESS_ID"\-d'{ "data": "BASE64_ENCODED_IV_AND_CIPHERTEXT_STRING" }'

核心实名核验数据解析与业务映射

接口响应外层 JSON 包含code、message、transaction_id（流水号）及加密的字符串data。将data通过 AES-128-CBC 解密后，即可获得面向首诊患者建档业务的核心字段。各字段的技术含义及医疗系统映射关系如下表所示：

字段名	类型	说明与枚举值	互联网医疗首诊建档业务映射逻辑
`order_no`	`string`	核验生成订单号	与医院 HIS/EMR 系统的患者建档流水号及外层`transaction_id`联合归档，作为监管审计备查凭证。
`result`	`string`	验证结果： `0`- 一致，收费 `1`- 不一致，收费 `2`- 无记录，不收费	核心准入开关： `0`：直接激活患者实名电子病历，允许医生开具电子处方； `1`：触发前置准入校验提醒，提示核对是否为亲属手机号； `2`：引导患者补充上传实体证件或转入导诊人工复核。
`desc`	`string`	结果描述文本	用于在后台管理端记录详细的核验反馈说明，辅助客服人员解答患者建档疑问。
`channel`	`string`	运营商标识： `cmcc`- 移动 `cucc`- 联通 `ctcc`- 电信 `gdcc`- 广电	记录患者号码所属运营商网络，供医院消息中台在发送电子处方审方结果、煎药配送通知及复诊提醒时精准匹配高到达率短信通道。
`sex`	`string`	性别	自动填入患者电子病历基础信息栏，并在挂号阶段与妇科、产科、男科等专科门诊规则进行一致性交叉复核。
`birthday`	`string`	生日	自动计算患者精确周岁年龄，为儿科专科分诊、老年慢病评估以及审方系统的年龄段安全用药剂量核算提供基准参数。
`address`	`string`	籍贯	自动补全电子病历中的患者籍贯信息，辅助全科医生在问诊初期快速建立地域流行病学史与饮食习惯参考。

技术提示：医疗健康问诊系统的日志审计需严格遵循个人信息保护规范（PII 合规）。在 PHP 应用层记录Monolog或系统审计日志时，严禁将明文的请求入参和响应字段直接落盘。建议对手机号执行掩码脱敏（如138****8000），对身份证号保留前 3 位与后 4 位（如110***********251X），对姓名进行局部隐藏（如*晓明），仅保留transaction_id、order_no与result状态码明文供链路追踪使用。

场景化应用：让核验数据赋能合规闭环

1. 互联网医院首诊患者电子病历（EMR）自动化建档与分诊校准

当患者首次在医疗健康小程序或 H5 门户发起图文问诊时，系统需为其建立唯一绑定的实名电子健康档案。

通过/匹配流转：当接口解密返回result为0（一致）时，PHP 建档服务自动将患者状态标记为“已实名核验”，并提取响应中的sex、birthday与address字段写入患者主索引表（EMPI）。若系统根据birthday核算患者年龄未满 14 周岁，分诊引擎自动为其优先匹配儿科资质医师；若患者挂号科室与sex存在冲突，前端即时弹出温馨确认提示，避免挂错科室。
补充验证/复核流转：若返回result为2（无记录，常见于刚办理入网尚未同步的号卡），系统不会简单拒绝患者求医，而是自动切换至“临时建档+人工复核提醒”模式，允许患者先与导诊护士沟通，并引导上传有效身份证件完成补充确认。

2. 处方药在线开具与审方流转前的家属代问诊合规识别

在互联网慢病复诊或老年、儿童患者问诊场景中，经常出现子女使用自己的手机号为父母或孩子填写身份信息进行建档的情况。如果直接将子女手机号作为患者本人的三要素进行核验，必然会触发信息不匹配。

通过/匹配流转：对于成年独立就诊患者，三要素核验返回result = 0后，处方流转网关直接放行，电子签名处方自动推送至药师审方台与医保结算通道。
补充验证/复核流转：当接口返回result = 1（不一致）时，PHP 业务层捕获该状态，不在前端生硬报错，而是主动弹出“您是否正在为家人代办问诊？”的交互引导窗。若用户确认为家属代诊，系统自动引导其进入“家庭成员健康档案绑定”流程——先核验操作人（监护人/家属）本人的姓名、身份证与手机号三要素一致性，通过后再关联就诊患者的身份信息，既消除了冒名开药的合规隐患，又照顾了老年与儿童群体的真实就医需求。

3. 诊后随访与电子处方用药提醒的多网通道智能路由

在线问诊结束后，平台需要向患者发送电子处方取药码、特殊药品（如胰岛素、抗凝药）定时服用提醒以及术后康复随访表单，短信触达的实时性直接关系到患者依从性与用药安全。

通过/匹配流转：在首诊建档核验返回result = 0的同时，PHP 后台将返回的channel字段（cmcc移动、cucc联通、ctcc电信、gdcc广电）持久化至患者通信偏好表。后续当医院随访系统触发定时用药通知时，消息网关直接根据已记录的channel标识将该号码路由至对应运营商的直连专线通道，规避跨网携号转网或通道拥塞导致的通知延迟。

生产环境接入的安全与合规边界

在将运营商三要素简版V即时版查询接口部署至生产环境的 PHP 医疗健康问诊系统时，架构师应从以下三个维度筑牢安全与合规边界：

患者知情同意与最小必要授权：
医疗健康数据与个人身份信息均属于高度敏感数据。在调用核验接口前，前端问诊页面必须设置独立、清晰的授权勾选交互，明确告知患者其姓名、身份证号与手机号将用于互联网诊疗实名建档核验，并在后端数据库中持久化记录患者签署授权书的时间戳、客户端 IP 及协议版本号，确保每一次接口调用均具备完整可追溯的合规授权链路。
全链路密文传输与敏感字段加密存储：
与接口通信时必须强制校验证书有效性，并使用动态随机生成的 16 字节 IV 配合 AES-128-CBC 模式加密请求负载，切勿在代码中复用固定 IV。对于医院本地数据库（如 MySQL/PostgreSQL）中需长期保存的患者id_card与mobile_no，应采用信创合规算法或应用层字段级加密后落盘，同时建立可搜索哈希索引以支持日常检索，防止明文数据泄露。
高并发问诊洪峰下的幂等缓存与限流控制：
每天上午 8:00–10:00 通常是互联网医院的挂号与首诊高峰期。由于result为0或1均会产生计费，PHP 网关层应基于 Redis 构建针对hash('sha256', $name . '|' . $idCard . '|' . $mobileNo)的短期幂等缓存（例如针对已核验一致的档案设置合理的有效周期，针对输入错误触发的result = 1设置防抖冷却窗口），防止患者因网络卡顿连续点击“提交建档”按钮引发重复扣费与上游通道瞬时并发过载。