'1.0', 'info' => ['style' => 'RPC', 'product' => 'Cloudauth', 'version' => '2019-03-07'], 'directories' => [ [ 'children' => ['LivenessFaceVerify', 'CompareFaceVerify', 'ContrastFaceVerify', 'DescribeFaceVerify', 'InitFaceVerify', 'DescribeFaceGuardRisk', 'AIGCFaceVerify', 'DeleteFaceVerifyResult'], 'type' => 'directory', 'title' => '金融级实人', 'id' => 321018, ], [ 'children' => [ [ 'children' => ['DeepfakeDetect'], 'type' => 'directory', 'title' => '人脸检测', 'id' => 321105, ], [ 'children' => ['CredentialProductVerifyV2', 'CredentialVerifyV2', 'CredentialVerify'], 'type' => 'directory', 'title' => '凭证检测', 'id' => 321107, ], [ 'children' => ['BankMetaVerify'], 'type' => 'directory', 'title' => '银行卡核验', 'id' => 321111, ], [ 'children' => ['MobileRecycledMetaVerify', 'MobileDetect', 'Mobile3MetaSimpleVerify', 'Mobile3MetaDetailVerify', 'Mobile2MetaVerify', 'MobileOnlineTime', 'MobileOnlineStatus', 'Mobile3MetaSimpleStandardVerify', 'Mobile3MetaDetailStandardVerify'], 'type' => 'directory', 'title' => '手机号核验', 'id' => 321113, ], [ 'children' => ['Id2MetaStandardVerify', 'Id2MetaVerify', 'Id2MetaVerifyWithOCR', 'Id3MetaVerify', 'Id2MetaPeriodVerify', 'InitCardVerify', 'DescribeCardVerify', 'Id3MetaVerifyWithOCR'], 'type' => 'directory', 'title' => '身份核验', 'id' => 321122, ], [ 'children' => ['VehicleMetaVerifyV2', 'VehicleMetaVerify', 'Vehicle5ItemQuery', 'VehicleQuery', 'VehicleInsureQuery'], 'type' => 'directory', 'title' => '车辆核验', 'id' => 321099, ], ], 'type' => 'directory', 'title' => '信息核验', 'id' => 321098, ], [ 'children' => ['VerifyMaterial', 'DescribeVerifyToken', 'DescribeVerifyResult', 'CompareFaces', 'DetectFaceAttributes'], 'type' => 'directory', 'title' => '实人认证(已停止售卖,文档停止更新)', 'id' => 321092, ], [ 'children' => [ 'DescribePageFaceVerifyData', 'CreateCloudauthstScene', 'DeleteCloudauthstScene', 'DescribeSmartStatisticsPageList', 'CreateAntCloudAuthScene', 'UpdateAntCloudAuthScene', 'DeleteAntCloudAuthScene', 'RemoveWhiteListSetting', 'InsertWhiteListSetting', 'PageQueryWhiteListSetting', [ 'children' => [ [ 'children' => ['DescribeVerifySDK'], 'type' => 'directory', 'title' => 'SDK', 'id' => 321034, ], ], 'type' => 'directory', 'title' => 'AIGC生成图片检测', 'id' => 321028, ], 'DeleteWhitelistSetting', 'CreateWhitelistSetting', 'DescribeWhitelistSetting', 'DescribeAntAndCloudAuthUserStatus', 'DescribeCloudauthstSceneList', 'DescribeListAntCloudAuthScenes', 'DescribeListFaceVerifyData', 'DescribeListFaceVerifyInfos', 'DescribeOssStatus', 'DescribePageSetting', 'DescribeProductCode', 'DescribeVerifyDeviceRiskStatistics', 'DescribeVerifyFailStatistics', 'DescribeVerifyPersonasDeviceModelStatistics', 'DescribeVerifyPersonasOsStatistics', 'DescribeVerifyPersonasProvinceStatistics', 'DescribeVerifyPersonasSexStatistics', 'DescribeVerifySearchPageList', 'DescribeVerifyStatistics', 'DescribeMetaSearchPageList', 'DescribeMetaStatisticsList', 'DescribeMetaStatisticsPageList', 'QuerySceneConfigs', 'CreateSceneConfig', 'UpdateSceneConfig', 'DeleteSceneConfig', 'QueryVerifyDownloadTask', 'DownloadVerifyRecords', 'QueryVerifyFlowPackage', 'QueryVerifyInvokeSatistic', 'QueryCustomizeFlowStrategy', 'DeleteCustomizeFlowStrategy', 'DeleteAllCustomizeFlowStrategy', 'ModifyCustomizeFlowStrategyList', 'ModifyControlStrategy', 'QueryControlStrategy', 'DeleteControlStrategy', 'ModifyBlackListStrategy', 'QueryBlackListStrategy', 'DeleteBlackListStrategy', 'DescribeInfoCheckExportRecord', 'DescribeOssStatusV2', 'DescribeAuthVerify', 'InitAuthVerify', 'CreateAuthKey', 'CreateVerifySetting', 'DescribeDeviceInfo', 'DescribeOssUploadToken', 'ModifyDeviceInfo', ], 'type' => 'directory', 'title' => '其他', 'id' => 321027, ], ], 'components' => [ 'schemas' => [], ], 'apis' => [ 'AIGCFaceVerify' => [ 'summary' => 'AIGC生成图片检测,输出检测标识。', 'methods' => ['post', 'get'], 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '206861', 'abilityTreeNodes' => ['FEATUREcloudauthHJ4WQV'], ], 'parameters' => [ [ 'name' => 'SceneId', 'in' => 'query', 'schema' => ['description' => '认证场景ID。该ID在控制台创建认证场景后自动生成。关于如何创建认证场景,请参见添加认证场景。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '100000xxxx'], ], [ 'name' => 'OuterOrderNo', 'in' => 'query', 'schema' => ['description' => '客户服务端自定义的业务唯一标识,用于后续定位排查问题。取值最长为32位长度的字母数字组合,请确保唯一。', 'type' => 'string', 'required' => false, 'example' => 'e0c34a77f5ac40a5aa5e6ed20c353888'], ], [ 'name' => 'ProductCode', 'in' => 'query', 'schema' => ['description' => '产品方案', 'type' => 'string', 'required' => false, 'example' => 'LR_FR_AIGC'], ], [ 'name' => 'FaceContrastPicture', 'in' => 'formData', 'schema' => ['description' => '照片Base64编码。'."\n" .'> 在FaceContrastPicture、FaceContrastPictureUrl、OSS三种图片传入方式中,选择其中一种传入即可。', 'type' => 'string', 'required' => false, 'example' => '/9j/4AAQSkZJRgABAQAASxxxxxxx'."\n"], ], [ 'name' => 'FaceContrastPictureUrl', 'in' => 'query', 'schema' => ['description' => '人像地址,公网可访问的HTTP、HTTPS链接。'."\n" ."\n" .'> 在FaceContrastPicture、FaceContrastPictureUrl、OSS三种图片传入方式中,选择其中一种传入即可。', 'type' => 'string', 'required' => false, 'example' => 'https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/verify/xxxxx/xxxxx.jpeg'], ], [ 'name' => 'OssBucketName', 'in' => 'query', 'schema' => ['description' => '已授权OSS空间的Bucket名 。'."\n" .'> 在FaceContrastPicture、FaceContrastPictureUrl、OSS三种图片传入方式中,选择其中一种传入即可。', 'type' => 'string', 'required' => false, 'example' => 'cn-shanghai-aliyun-cloudauth-xxxxx'."\n"], ], [ 'name' => 'OssObjectName', 'in' => 'query', 'schema' => ['description' => '已授权OSS空间的文件名。'."\n" .'> 在FaceContrastPicture、FaceContrastPictureUrl、OSS三种图片传入方式中,选择其中一种传入即可。', 'type' => 'string', 'required' => false, 'example' => ' '."\n" .'verify/xxxxx/xxxxxx.jpeg'."\n"], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => '响应对象', 'type' => 'object', 'properties' => [ 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E'], 'Message' => ['description' => '消息。', 'type' => 'string', 'example' => 'success'], 'Code' => ['description' => '返回码:200为成功,其他为失败。', 'type' => 'string', 'example' => '200'], 'ResultObject' => [ 'description' => '返回的结果', 'type' => 'object', 'properties' => [ 'Result' => [ 'description' => '认证结果。取值:'."\n" ."\n" .'● Y:AIGC生成人脸。'."\n" ."\n" .'● N:未检测到', 'type' => 'string', 'enumValueTitles' => ['Y' => 'AIGC生成人脸', 'N' => '非AIGC生成人脸'], 'example' => 'Y', ], 'Score' => ['description' => '检测的分数', 'type' => 'string', 'example' => '1.0000'], 'CertifyId' => ['description' => '实人认证唯一标识。', 'type' => 'string', 'example' => '91707dc296d469ad38e4c5efa6a0****'], ], ], ], ], ], ], 'staticInfo' => ['returnType' => 'synchronous'], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"Message\\": \\"success\\",\\n \\"Code\\": \\"200\\",\\n \\"ResultObject\\": {\\n \\"Result\\": \\"Y\\",\\n \\"Score\\": \\"1.0000\\",\\n \\"CertifyId\\": \\"91707dc296d469ad38e4c5efa6a0****\\"\\n }\\n}","type":"json"}]', 'title' => 'AIGC生成图片检测', 'changeSet' => [ ['createdAt' => '2024-03-13T02:12:38.000Z', 'description' => '响应参数发生变更'], ], 'flowControl' => [ 'flowControlList' => [ ['threshold' => '2', 'countWindow' => 1, 'regionId' => '*', 'api' => 'AIGCFaceVerify'], ], ], 'ramActions' => [ [ 'operationType' => 'none', 'ramAction' => [ 'action' => 'yundun-cloudauth:DescribeAIGCFaceVerify', 'authLevel' => 'operate', 'actionConditions' => [], 'resources' => [ ['validationType' => 'always', 'product' => 'Cloudauth', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], ], ], 'BankMetaVerify' => [ 'methods' => ['post', 'get'], 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'paid', 'abilityTreeCode' => '208613', 'abilityTreeNodes' => ['FEATUREcloudauth883TGF'], ], 'parameters' => [ [ 'name' => 'ParamType', 'in' => 'query', 'schema' => [ 'description' => '参数类型:'."\n" ."\n" .'- normal:不加密。'."\n" .'- md5:MD5加密。', 'type' => 'string', 'required' => false, 'enumValueTitles' => ['normal' => 'normal', 'md5' => 'md5'], 'example' => 'normal', ], ], [ 'name' => 'VerifyMode', 'in' => 'query', 'schema' => ['description' => 'VERIFY_BANK_CARD:银行卡认证模式。表示将传入的银行卡号和用户的真实姓名、身份证号,手机号是否匹配。', 'type' => 'string', 'required' => false, 'example' => 'VERIFY_BANK_CARD'], ], [ 'name' => 'ProductType', 'in' => 'query', 'schema' => ['description' => '调用产品类型:'."\n" ."\n" .'- BANK_CARD_2_META:银⾏卡号+姓名核验。'."\n" .'- BANK_CARD_3_META:银⾏卡号+姓名+身份证号核验。'."\n" .'- BANK_CARD_4_META:银⾏卡号+姓名+身份证号+⼿机号核验。', 'type' => 'string', 'required' => false, 'example' => 'BANK_CARD_2_META'], ], [ 'name' => 'UserName', 'in' => 'query', 'schema' => ['description' => '姓名。'."\n" ."\n" .'- 当paramType取值normal时,输入姓名明文。'."\n" .'- 当paramType取值md5时,姓名第一个字MD5加密(32位小写MD5)+ 姓名其他部分明文。', 'type' => 'string', 'required' => false, 'example' => '张*'], ], [ 'name' => 'IdentifyNum', 'in' => 'query', 'schema' => ['description' => '身份证号。'."\n" ."\n" .'- 当ProductType取值BANK_CARD_3_META时,此项必选。'."\n" .'- 当paramType取值normal时,输入身份证号明文。'."\n" .'- 当paramType取值md5时,身份证号前6位明文+出生年月日md5加密(32位小写MD5)+身份证号后4位。', 'type' => 'string', 'required' => false, 'example' => '429001********8211'], ], [ 'name' => 'BankCard', 'in' => 'query', 'schema' => ['description' => '银行卡号。'."\n" ."\n" .'- 当paramType取值normal时,输入银行卡号明文。'."\n" .'- 当paramType取值md5时,卡号除最后6位其他部分明文+最后6位md5值(32位小写)。', 'type' => 'string', 'required' => false, 'example' => '610*************1181'], ], [ 'name' => 'Mobile', 'in' => 'query', 'schema' => ['description' => '手机号。'."\n" ."\n" .'- 当ProductType取值BANK_CARD_4_META时,此项必选。'."\n" .'- 当paramType取值normal时,输入手机号明文。'."\n" .'- 当paramType取值md5时,输入手机号(32位小写MD5)。', 'type' => 'string', 'required' => false, 'example' => '138******11'], ], [ 'name' => 'IdentityType', 'in' => 'query', 'schema' => ['description' => '证件类型。', 'type' => 'string', 'required' => false, 'example' => '01'], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-A***B-A3DC0DE3C83E'], 'Code' => ['description' => '返回码:200为成功,其他为失败。', 'type' => 'string', 'example' => '200'], 'Message' => ['description' => '返回信息。', 'type' => 'string', 'example' => 'success'], 'ResultObject' => [ 'description' => '返回的结果信息', 'type' => 'object', 'properties' => [ 'BizCode' => ['description' => '核验结果。'."\n" ."\n" .'- 1:校验⼀致(计费)'."\n" .'- 2:校验不⼀致(计费)'."\n" .'- 3:查⽆记录(不计费)', 'type' => 'string', 'example' => '1'], 'SubCode' => ['description' => '核验详情:'."\n" ."\n" .'- **101**:验证通过。'."\n" .'- **201**:认证信息不一致,持卡人信息有误。'."\n" .'- **202**:认证信息不一致,银行卡未开通认证支付。'."\n" .'- **203**:认证信息不一致,银行卡已过期。'."\n" .'- **204**:认证信息不一致,银行卡为受限制的卡。'."\n" .'- **205**:认证信息不一致,此卡被没收。'."\n" .'- **206**:认证信息不一致,银行卡无效。'."\n" .'- **207**:认证信息不一致,此卡无对应发卡行。'."\n" .'- **208**:认证信息不一致,该卡未初始化或睡眠卡。'."\n" .'- **209**:认证信息不一致,此卡为作弊卡、吞卡。'."\n" .'- **210**:认证信息不一致,此卡已挂失。'."\n" .'- **211**:认证信息不一致,密码错误次数超限。'."\n" .'- **212**:认证信息不一致,发卡行不支持此交易。'."\n" .'- **213**:认证信息不一致,卡状态不正常或卡无效。'."\n" .'- **214**:认证信息不一致,未预留手机号。'."\n" .'- **215**:认证信息不一致,输入的密码、有效期或CVN2有误。'."\n" .'- **216**:认证信息不一致,其他卡异常情况。'."\n" .'- **301**:无法验证,银行卡不支持该业务。'."\n" .'- **302**:无法验证,验证失败或银行拒绝验证,请联系发卡行。'."\n" .'- **303**:无法验证,银行卡暂不支持手机号验证。'."\n" .'- **304**:无法验证,银行卡号有误。'."\n" .'- **305**:无法验证,其他原因。'."\n" .'- **306**:无法验证,验证次数超限。', 'type' => 'string', 'example' => '101'], ], ], ], ], ], ], 'staticInfo' => ['returnType' => 'synchronous'], 'title' => '银行卡二,三,四要素核验', 'summary' => '银行卡要素(银行卡二要素、银行卡三要素和银行卡四要素)API接口。', 'description' => '银行卡核验, 包含:银行卡二要素(姓名+银行卡号),银行卡三要素(姓名+身份证号码+银行卡号)四要素(姓名+身份证号码+手机号+银行卡号)的一致性核验。'."\n" .'- 服务地址:'."\n" .' - 北京地域:cloudauth.cn-beijing.aliyuncs.com(IPv4)或cloudauth-dualstack.cn-beijing.aliyuncs.com(IPv6)。'."\n" .' - 上海地域:cloudauth.cn-shanghai.aliyuncs.com(IPv4)或cloudauth-dualstack.cn-shanghai.aliyuncs.com(IPv6)。'."\n" .'- 请求方法:POST和GET。'."\n" .'- 传输协议:HTTPS。', 'changeSet' => [ ['createdAt' => '2024-09-04T07:32:50.000Z', 'description' => '请求参数发生变更'], ], 'flowControl' => [ 'flowControlList' => [ ['threshold' => '50', 'countWindow' => 1, 'regionId' => '*', 'api' => 'BankMetaVerify'], ], ], 'ramActions' => [ [ 'operationType' => 'none', 'ramAction' => [ 'action' => 'yundun-cloudauth:BankMetaVerify', 'authLevel' => 'operate', 'actionConditions' => [], 'resources' => [ ['validationType' => 'always', 'product' => 'Cloudauth', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"473469C7-A***B-A3DC0DE3C83E\\",\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"success\\",\\n \\"ResultObject\\": {\\n \\"BizCode\\": \\"1\\",\\n \\"SubCode\\": \\"101\\"\\n }\\n}","type":"json"}]', ], 'CompareFaceVerify' => [ 'summary' => '金融级人脸比对纯服务端API。', 'methods' => ['post', 'get'], 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', 'riskType' => 'high', 'chargeType' => 'paid', 'abilityTreeCode' => '59095', 'abilityTreeNodes' => ['FEATUREcloudauthHJ4WQV'], ], 'parameters' => [ [ 'name' => 'SceneId', 'in' => 'formData', 'schema' => ['description' => '认证场景ID。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1000000006'], ], [ 'name' => 'OuterOrderNo', 'in' => 'formData', 'schema' => ['description' => '商户请求的唯一标识。'."\n" ."\n" .'值为32位长度的字母数字组合前面几位字符是商户自定义的简称,中间可以使用一段时间,后段可以使用一个随机或递增序列。', 'type' => 'string', 'required' => false, 'example' => 'e0c34a77f5ac40a5aa5e6ed20c353888'], ], [ 'name' => 'ProductCode', 'in' => 'formData', 'schema' => ['description' => '固定值:PV_FC。', 'type' => 'string', 'required' => false, 'example' => 'PV_FC'], ], [ 'name' => 'SourceFaceContrastPicture', 'in' => 'formData', 'schema' => ['description' => '照片Base64编码。'."\n" ."\n" .'> FaceContrastPicture、FaceContrastPictureUrl、CertifyId、OSS四种人脸照片传入方式,选择其中一种传入即可。', 'type' => 'string', 'required' => false, 'example' => '/9j/4AAQSkZJRgABAQAASxxxxxxx', 'maxLength' => 1048676], ], [ 'name' => 'SourceFaceContrastPictureUrl', 'in' => 'formData', 'schema' => ['description' => 'OSS照片地址,目前只支持已授权OSS照片地址。'."\n" ."\n" .'> FaceContrastPicture、FaceContrastPictureUrl、CertifyId、OSS四种人脸照片传入方式,选择其中一种传入即可。', 'type' => 'string', 'required' => false, 'example' => 'https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/verify/xxxxx/xxxxx.jpeg'], ], [ 'name' => 'SourceCertifyId', 'in' => 'formData', 'schema' => ['description' => '之前实人认证通过的CertifyId,认证时的照片作为人脸比对照片。'."\n" ."\n" .'> FaceContrastPicture、FaceContrastPictureUrl、CertifyId、OSS四种人脸照片传入方式,选择其中一种传入即可。', 'type' => 'string', 'required' => false, 'example' => '0bfa7c493f850e5178b9f8613634c9xx'], ], [ 'name' => 'SourceOssBucketName', 'in' => 'formData', 'schema' => ['description' => '已授权OSS空间的 Bucket 名。'."\n" ."\n" .'> FaceContrastPicture、FaceContrastPictureUrl、CertifyId、OSS四种人脸照片传入方式,选择其中一种传入即可。', 'type' => 'string', 'required' => false, 'example' => 'cn-shanghai-aliyun-cloudauth-xxxxx'], ], [ 'name' => 'SourceOssObjectName', 'in' => 'formData', 'schema' => ['description' => '已授权OSS空间的文件名。'."\n" ."\n" .'> FaceContrastPicture、FaceContrastPictureUrl、CertifyId、OSS四种人脸照片传入方式,选择其中一种传入即可。', 'type' => 'string', 'required' => false, 'example' => 'verify/xxxxx/xxxxxx.jpeg'], ], [ 'name' => 'TargetFaceContrastPicture', 'in' => 'formData', 'schema' => ['description' => '底库照片Base64编码。'."\n" ."\n" .'> FaceContrastPicture、FaceContrastPictureUrl、CertifyId、OSS四种底库人脸照片传入方式,选择其中一种传入即可。', 'type' => 'string', 'required' => false, 'example' => '/9j/4AAQSkZJRgABAQAASxxxxxxx', 'maxLength' => 1048676], ], [ 'name' => 'TargetFaceContrastPictureUrl', 'in' => 'formData', 'schema' => ['description' => '底库OSS照片地址,目前只支持已授权OSS照片地址。'."\n" ."\n" .'> FaceContrastPicture、FaceContrastPictureUrl、CertifyId、OSS四种底库人脸照片传入方式,选择其中一种传入即可。', 'type' => 'string', 'required' => false, 'example' => 'https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/verify/xxxxx/xxxxx.jpeg'], ], [ 'name' => 'TargetCertifyId', 'in' => 'formData', 'schema' => ['description' => '之前实人认证通过的 CertifyId,认证时的照片作为人脸比对照片。'."\n" ."\n" .'> FaceContrastPicture、FaceContrastPictureUrl、CertifyId、OSS四种底库人脸照片传入方式,选择其中一种传入即可。', 'type' => 'string', 'required' => false, 'example' => '0bfa7c493f850e5178b9f8613634c9xx'], ], [ 'name' => 'TargetOssBucketName', 'in' => 'formData', 'schema' => ['description' => '已授权OSS空间的Bucket名 。'."\n" ."\n" .'> FaceContrastPicture、FaceContrastPictureUrl、CertifyId、OSS四种底库人脸照片传入方式,选择其中一种传入即可。', 'type' => 'string', 'required' => false, 'example' => 'cn-shanghai-aliyun-cloudauth-xxxxx'], ], [ 'name' => 'TargetOssObjectName', 'in' => 'formData', 'schema' => ['description' => '已授权OSS空间的文件名。'."\n" ."\n" .'> FaceContrastPicture、FaceContrastPictureUrl、CertifyId、OSS四种底库人脸照片传入方式,选择其中一种传入即可。', 'type' => 'string', 'required' => false, 'example' => 'verify/xxxxx/xxxxxx.jpeg'], ], [ 'name' => 'Crop', 'in' => 'formData', 'schema' => ['description' => '是否允许裁剪,默认不允许,T/F'."\n" ."\n" .'- T:表示需要检测'."\n" .'- F:表示需要检测(默认F)', 'type' => 'string', 'required' => false, 'example' => 'T'], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Code' => ['description' => '返回码:200为成功,其他为失败。', 'type' => 'string', 'example' => '200'], 'Message' => ['description' => '错误信息。', 'type' => 'string', 'example' => 'success'], 'RequestId' => ['description' => '请求 ID。', 'type' => 'string', 'example' => '130A2C10-B9EE-4D84-88E3-5384FF039795'], 'ResultObject' => [ 'description' => '人脸比对结果信息。', 'type' => 'object', 'properties' => [ 'CertifyId' => ['description' => '实人认证请求的唯一标识。', 'type' => 'string', 'example' => '08573be80f944d95ac812e019e3655a8'], 'VerifyScore' => ['description' => '人脸比对分。', 'type' => 'number', 'format' => 'float', 'example' => '99.60875'], 'Passed' => ['description' => '是否通过,通过为T,不通过为F。', 'type' => 'string', 'example' => 'T'], ], ], ], 'description' => '', ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"130A2C10-B9EE-4D84-88E3-5384FF039795\\",\\n \\"ResultObject\\": {\\n \\"CertifyId\\": \\"08573be80f944d95ac812e019e3655a8\\",\\n \\"VerifyScore\\": 99.60875,\\n \\"Passed\\": \\"T\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"","errorExample":""}]', 'title' => '人脸比对方案纯服务端API', 'description' => '- 接口名:CompareFaceVerify。'."\n" .'- 服务地址:cloudauth.aliyuncs.com。'."\n" .'- 请求方法:HTTPS POST和GET。'."\n" .'- 接口说明:通过服务端接入实现实人认证的接口。'."\n" ."\n" .'#### 传入照片格式要求'."\n" .'当您在进行人脸比对的时候,请传入满足以下所有条件的2张人脸照片。'."\n" ."\n" .'- 近期照片/底库近期照片,人脸完整清晰无遮挡,表情自然,正对摄像头。'."\n" .'- 照片清晰、曝光正常,脸部无过黑、过亮、光晕等情况、角度无太大偏差。'."\n" .'- 分辨率不超过1920\\*1080,至少640\\*480,推荐短边缩放到720像素,压缩率大于0.9。'."\n" .'- 照片大小:<1MB。'."\n" .'- 支持 90、180 和270度照片,多人脸的情况会选取最大脸。', 'requestParamsDescription' => '> 以Source开头的参数代表您要上传的近期人脸照片参数,以Target开头的参数代表您要上传的底库近期人脸照片参数。传入照片格式要求请参见[传入照片格式要求](#传入照片格式要求)。'."\n" .'如果您选择OSS方式传入人脸照片,您必须同时传入OssBucketName和OssObjectName字段。OSS入参格式仅支持开通实人认证时授权的OSS生成的URL、Bucket和文件名 。关于如何查询授权的OSS,请参见[开通OSS空间并授权](https://help.aliyun.com/document_detail/163532.html?spm=a2c4g.11186623.2.15.36945bc3y5uWz6#title-409-lcd-pp0) 。'."\n" .'如果您选择FaceContrastPicture(照片Base64编码)方式传入人脸照片,请注意检查照片大小,不要传入过大的照片;您可以通过OSS方式上传较大的人脸照片。', 'responseParamsDescription' => '返回值示例:'."\n" ."\n" .'```'."\n" .'{'."\n" .' "Code": "200",'."\n" .' "Message": "success",'."\n" .' "RequestId": "23699272-B263-4B6C-BC04-0EBA1AB6F6D5",'."\n" .' "ResultObject": {'."\n" .' "Passed": "T",'."\n" .' "VerifyScore": 99.60875'."\n" .' }'."\n" .'}'."\n" .'```', 'extraInfo' => ' ## 返回码'."\n" ."\n" .'|返回码|返回信息|描述|'."\n" .'|----|-------|--|'."\n" .'|200|success|成功。|'."\n" .'|400|参数不能为空|参数不能为空。|'."\n" .'|401|参数非法|非法参数。传入的姓名、身份证号码长度必须符合国家标准且不得包含英文字母等特殊字符。|'."\n" .'|402|应用配置不存在|应用配置不存在。|'."\n" .'|404|认证场景配置不存在|认证场景配置不存在,请先在控制台上创建认证场景。|'."\n" .'|410|未开通服务|未开通OSS产品或未完成OSS读写授权,请登录控制台完成授权。|'."\n" .'|411|RAM 无权限|需要给子账号授予AliyunAntCloudAuthFullAccess的操作权限。|'."\n" .'|412|欠费中|金融级实人认证或OSS存在欠费,请充值后操作。|'."\n" .'|419|传入图片不可用|图片无法下载、图片内容为空、图片分辨率不符合要求或提取不到人脸特征,建议更换图片。|'."\n" .'|420|数据重复|图片传入方式超过2种。