OCR接口.md
19.8 KB
扬州-招行OCR和人脸认证接口
报文格式
-
请求报文格式示例
{ "params": { "type": "idcard", "imageType": "jpg", .... }, "httpurl": "招行服务地址，可为空" } -
应答报文格式示例
{ "result": { "data": [响应明细信息] }, "error_msg": "响应说明", "error_code": "错误成功代码，0成功 其他失败", "xybw": "招行响应的原始报文" }
身份证OCR接口
- 接口：POST esb_wl_test/service/zh/getSfzOcr
-
请求报文示例
{ "params": { "type": "idcard", "imageType": "jpg", "fileName": "idcard.jpg", "image": "需识别图片的base64编码字符串" }, "httpurl": "" } -
应答报文示例
{ "result": { "data": [ { "value": "back", "key": "side" }, { "value": "", "key": "validDateEnd" }, { "value": "", "key": "validDateBegin" }, { "value": "1987年09月17日", "key": "birthday" }, { "value": "汉", "key": "nation" }, { "value": "2", "key": "sex" }, { "value": "1", "key": "imageType" }, { "value": "", "key": "issureBy" }, { "value": "小静", "key": "name" }, { "value": "1", "key": "isComplete" }, { "value": "北京市海淀区西北旺东路100号中关村科技园", "key": "address" }, { "value": "370782198709170246", "key": "identityNo" } ] }, "error_msg": "Success", "error_code": "0", "xybw": "{\"code\":200,\"imageID\":\"479711110249906176\",\"data\":[{\"value\":\"back\",\"key\":\"side\"},{\"value\":\"\",\"key\":\"validDateEnd\"},{\"value\":\"\",\"key\":\"validDateBegin\"},{\"value\":\"1987年09月17日\",\"key\":\"birthday\"},{\"value\":\"汉\",\"key\":\"nation\"},{\"value\":\"2\",\"key\":\"sex\"},{\"value\":\"1\",\"key\":\"imageType\"},{\"value\":\"\",\"key\":\"issureBy\"},{\"value\":\"小静\",\"key\":\"name\"},{\"value\":\"1\",\"key\":\"isComplete\"},{\"value\":\"北京市海淀区西北旺东路100号中关村科技园\",\"key\":\"address\"},{\"value\":\"370782198709170246\",\"key\":\"identityNo\"}],\"message\":\"Success\",\"type\":\"idcard\",\"process_time\":1.03}" }
下载人脸识别协议
- 接口：POST esb_wl_test/service/zh/getFaceContract
-
请求报文示例
{ "params": {}, "httpurl": "" } -
应答报文示例
{ "result": { "data": { "agtStr": "<p class='MsoNormal'><strong><span style='line-height:120%'>重要提示：</span></strong></p><p style='text-indent:2em;'><strong><span style='line-height:120%'>尊敬的客户，为了维护您的权益，请您在签署本协议前认真阅读本协议全文，尤其是加黑加粗条款。如有疑义，请及时通过招商银行的客户服务及投诉电话：95555，要求我行予以说明。如您仍有疑问或不明之处，请咨询您的律师和有关专业人士。</span></strong></p><p style='text-align:center;' class='MsoNormal' align='center'><span style='font-size:20px'><span style='line-height:4'>人脸识别服务协议</span></span></p><p style='text-indent:2em;'>鉴于：1、您作为完全民事行为能力人已在调用方系统成功完成注册或个人身份信息登记，并申请使用此人脸识别服务；2、此人脸识别服务由招商银行股份有限公司（以下简称“招商银行”）提供，由包括但不限于“互联网+可信身份认证平台”等机构提供核验数据及技术支持。</p><p style='text-indent:2em;'><strong>为了保证您更好地使用此人脸识别服务，请您先仔细阅读本协议全部内容。如您对本协议内容及页面提示信息有疑问，请勿进行下一步操作。如果您在页面勾选、点击确认或以招商银行认可的其他方式确认本协议，即表示您已充分阅读、理解并同意本协议。您理解并认可本协议在调用方系统进行线上签署并提供给招商银行，承诺认可此种签署方式对您的法律约束力。</strong></p><p></p><p><strong>一、定义</strong></p><p style='text-indent:2em;'>1. <strong>人脸识别身份验证服</strong>（以下简称为“人脸识别服务”或“本服务”）：是指招商银行使用人工智能等技术，通过人脸比对等方式核验您的个人身份信息，并将核验结果反馈给为您提供产品或服务的调用方及调用方系统。</p><p style='text-indent:2em;'>2. <strong>个人身份信息：</strong>包括但不限于<strong>姓名、身份证号码及人脸信息</strong>等，在本协议中特指用于实现本服务的必要信息。</p><p style='text-indent:2em;' size='0' _root='undefined' __ownerid='undefined' __hash='undefined' __altered='false'>3. <strong>人脸信息：</strong>通过调用摄像头等设备采集、或者通过系统间调用、或者您自行提交等方式获取的，包括但不限于<strong>人脸图片、视频、人脸特征</strong>等信息。</p><p style='text-indent:2em;'>4. <strong>调用方：</strong>直接或间接为您提供产品或服务的组织、个人。</p><p style='text-indent:2em;'>5. <strong>调用方系统：</strong>由调用方或者其合作机构研发的软件系统，该调用方系统调用本服务用于完成您在具体场景中的人脸识别过程</p><p class='MsoNormal'><strong>二、双方的权利与义务</strong></p><p style='text-indent:2em;' class='MsoNormal'><strong>1.</strong> <strong>您已同意并授权招商银行采集和使用您的个人身份信息（含调用方向招商银行提供的您的个人身份信息），并对该信息做必要的处理，包括存储、提取、运算、对比、分析等，以完成人脸识别服务。</strong></p><p style='text-indent:2em;' class='MsoNormal'>2. 为实现本服务的身份核验功能，招商银行与包括但不限于“互联网+可信身份认证平台”等机构合作，由其提供核验数据和技术支持。<strong>您同意并授权招商银行在必要时将您的个人身份信息与该第三方合作机构所保存的您的数据进行比对核验或传送至该机构进行比对核验</strong>。</p><p style='text-indent:2em;' class='MsoNormal'><strong>3.</strong> <strong>您同意并授权调用方及调用方系统获取招商银行提供的本服务的核验结果及过程相关信息，您对此确认无异议。</strong></p><p style='text-indent:2em;' class='MsoNormal'><strong>4.</strong> 招商银行承诺在本协议服务范围内对您的个人身份信息采取严格的保密措施，招商银行将尽商业上的合理努力去要求与招商银行合作的第三方主体对您的个人身份信息进行严格保密。</p><p style='text-indent:2em;' class='MsoNormal'><strong>5.</strong> <strong>您已确切知悉，因为数据处理等客观技术原因，存在人脸识别服务结果与实际结果不能百分之百相符的情况，招商银行会将在何种数据分析精度下得出的人脸识别结果告知调用方，并由调用方最终确定是否应用该结果。当出现认证结果不符时，招商银行可配合您进行相关问题处理，但不对调用方是否应用认证结果以及由此引发的任何后果承担任何责任。</strong></p><p style='text-indent:2em;' class='MsoNormal'><strong>6.</strong> <strong>您已确切知悉，当招商银行与第三方合作时，也同样存在认证结果与实际结果不符的可能性，招商银行可与第三方沟通并进行相关问题处理，但不对调用方最终是否应用认证结果以及由此引发的任何后果承担任何责任。</strong></p><p style='text-indent:2em;' class='MsoNormal'><strong>7.</strong> 您已知晓并同意招商银行仅按本协议约定向您提供人脸识别服务，调用方向您提供的具体商品与服务，不在招商银行服务范围之内。<strong>您与调用方之间就具体商品与服务的争议和纠纷，以及调用方对您造成的风险和损失由您与调用方协商解决，招商银行不承担责任。</strong></p><p style='text-indent:2em;' class='MsoNormal'><strong>8.</strong> <strong>您已知晓并同意，招商银行不承担因调用方和第三方合作机构的原因对您造成的风险和损失。</strong>但是，如果发生风险事件，招商银行将按照法律法规的要求，在合理范围内采取必要措施和提供积极协助，以尽可能减少您的损失。</p><p style='text-indent:2em;' class='MsoNormal'><strong>9.</strong> <strong>您承诺所提供的个人信息为本人自愿提供，您保证其为履行本协议而向招商银行提供的全部资料均真实、有效，您确认其所有操作均为其本人的真实意思表示。</strong>您不得利用本服务从事侵犯他人名誉、隐私等合法权益或从事其他有关违法违规的活动，<strong>招商银行不对您使用本服务的用途和目的承担任何责任。</strong></p><p style='text-indent:2em;' class='MsoNormal'><strong>10.</strong> <strong>您理解并同意，与招商银行的合同关系终止后：您在使用服务期间存在违法行为或违反本协议的行为的，招商银行仍可依据本协议向您主张权利或依法依规向行政、司法等机关进行披露。</strong></p><p style='text-indent:2em;' class='MsoNormal'><strong>11.</strong> 招商银行将在现有技术能力基础上不断提升人脸识别结果的准确性。但是，由于网络的稳定性，以及采集人脸信息易受表情、妆容、环境等可变因素影响，且采集到的信息范围有限、技术水平及认证手段也仍在持续改进之中，<strong>招商银行不对人脸识别结果的准确性做出保证。如果您因人脸识别结果的准确性问题而遭受其他不利影响或者产生损失的，招商银行不对此承担责任。</strong></p><p style='text-indent:2em;' class='MsoNormal'><strong>12.</strong> 双方均确认，本协议的签订、生效和履行以不违反法律为前提。如果本协议中的任何一条或多条被司法部门认定为违反所须适用的法律，则该条将被视为无效，但该无效条款并不影响本协议其他条款的效力。</p><p class='MsoNormal'><strong>三、信息保密条款</strong></p><p style='text-indent:2em;' class='MsoNormal'>1. 招商银行尊重并保护您的隐私权。在您使用本服务的过程中，招商银行将为您的数据安全采取必要且严格的保密措施。</p><p style='text-indent:2em;' class='MsoNormal'><strong>2.</strong> <strong>为实现本协议约定的人脸识别服务，招商银行将采集您的个人身份信息，包括您的姓名、身份证号码和人脸信息等资料，您应按招商银行要求提供真实、准确、完整的相关信息。</strong></p><p style='text-indent:2em;' class='MsoNormal'>3. 为提升人脸识别结果的准确性以及提高有关技术性能和服务水平，<strong>招商银行将对您的上述个人信息做必要的处理</strong>，<strong>包括提取、运算、传输、存储等，以及必要时向第三方合作机构发送以进行辅助核验等。</strong></p><p style='text-indent:2em;' class='MsoNormal'><strong>4.</strong> <strong>您理解，尽管招商银行依法对您的上述信息执行严格保密措施，但是由于技术水平限制及可能存在的各种恶意手段，招商银行不对可控范围外因素造成的风险和损失承担责任。</strong></p><p style='text-indent:2em;' class='MsoNormal'>5. 提醒您注意，<strong>调用方与您的信息保密义务不在本协议范围之内，除您授权调用方将您的相关信息提供给招商银行之外，请您与调用方另行约定，招商银行不对调用方造成的隐私安全责任承担任何责任。</strong></p><p class='MsoNormal'><strong>四、责任限制</strong></p><p style='text-indent:2em;' class='MsoNormal'><strong>1.</strong> <strong>不可抗力：</strong>不可抗力是指不能合理控制、不可预见或不可克服的客观因素或意外事件，包括但不限于政府行为、国家政策调整、法律法规规章制定或修订、社会事件、自然灾害、战争、计算机病毒、黑客攻击、第三方（包括但不限于电信运营商、云服务提供商、机房服务商等）网络或通信安全问题，或任何其他类似事件。<strong>由于不可抗力致使招商银行延迟或未能履约的，招商银行不承担任何责任。</strong></p><p style='text-indent:2em;' class='MsoNormal'><strong>2.</strong> <strong>招商银行不对调用方和第三方合作机构的行为作出承诺或承担担保责任，因第三方合作机构或调用方的原因对您造成的风险和损失不在招商银行责任范围。</strong></p><p class='MsoNormal'><strong>五、协议解释</strong></p><p style='text-indent:2em;' class='MsoNormal'>1. <strong>您签署确认本协议后，只要您使用招商银行提供的人脸识别服务，本协议内容即对您具有约束力</strong>，除非双方经协商一致通过书面协议进行终止。</p><p style='text-indent:2em;' class='MsoNormal'>2. 本协议中的任何条款无论因何种原因完全或部分无效或不具有执行力，本协议的其余条款仍应有效并且具有约束力。</p><p class='MsoNormal'><strong>六、协议的签署形式</strong></p><p style='text-align:left;text-indent:2em;' class='MsoNormal' align='left'>如您对本协议条款内容有任何疑问，可向招商银行客服咨询。</p><p style='text-align:left;text-indent:2em;' class='MsoNormal' align='left'><strong>本协议为招商银行提供并嵌入调用方系统，一旦您在调用方系统勾选本协议、点击“同意”或“接受”或“注册”或“下一步”等确认按钮进行下一步操作，则视同认可本协议内容和有效签署本协议，与招商银行之间自动形成协议关系，应当受本协议条款的约束。</strong></p><p class='MsoNormal'><strong>七、协议的更新、变更</strong></p><p style='text-align:left;text-indent:2em;' class='MsoNormal' align='left'><strong>1.招商银行有权在必要时修改本协议条款。</strong> <strong>本协议条款更新后，您如果不同意更新内容，有权拒绝使用本服务；如果您继续使用本服务，即视为您已接受修改后的协议。</strong></p><p style='text-indent:2em;' class='MsoNormal'><strong>2.</strong> 为了配合技术进步并改善用户体验，招商银行将会持续改进并为用户提供版本升级、功能升级等服务，这些更新将会同步在协议条款当中。<strong>您如果不同意更新内容，有权拒绝使用本服务；如您继续使用招商银行人脸识别服务，则表示您同意更新后的协议条款。</strong></p><p style='text-indent:2em;' class='MsoNormal'><strong>3.协议的更新将通过招商银行官网、招商银行企业开放平台、招商银行微信公众号等公开网站或平台进行发布，请及时关注。</strong></p><p class='MsoNormal'><strong>八、争议解决</strong></p><p style='text-indent:2em;' class='MsoNormal'>1. 本协议的签订地为广东省深圳市。</p><p style='text-indent:2em;' class='MsoNormal'><strong>1.</strong> <strong>双方在履行本协议的过程中，如发生争议，应友好协商解决。协商不成的，应向广东省深圳市有管辖权的人民法院提起诉讼解决。</strong></p><p class='MsoNormal'><strong>九、通知与送达</strong></p><p style='text-indent:2em;'>1.招商银行将您的人脸识别结果、服务协议文本内容、或其它重要信息通过接口等方式向调用方系统反馈。请您及时关注并查看。</p><p style='text-align:left;text-indent:2em;' class='MsoNormal' align='left'><strong>2. 您应当保证和维持资料的完整性、有效性，您的资料若存在虚假、无效等任何可能导致您无法及时获取相关信息的，由您自行承担相应责任。</strong></p><p style='text-indent:2em;' class='MsoNormal'><strong><span style='line-height:120%'>您声明如下：</span></strong></p><p style='text-indent:2em;' class='MsoNormal'><strong><span style='line-height:120%'>招商银行已提请您特别注意有关免除或减轻招商银行责任等与您有重大利害关系的条款，并应您的要求对上述条款作出相应的说明。您已对其作全面、准确的理解。您和招商银行对本协议条款的理解完全一致。</span></strong></p><p style='text-indent:2em;' class='MsoNormal'><span style='line-height:120%'>（以下无正文）</span></p>" } }, "error_msg": "成功", "error_code": "0", "xybw": "{\"code\":\"0000\",\"msg\":\"成功\",\"content\":{\"agtStr\":\"<p class='MsoNormal'><strong><span style='line-height:120%'></span>...</p>\"}}" }
用户签约
- 接口：POST esb_wl_test/service/zh/getFaceSignContract
-
请求报文示例
{ "params": { "name": "小静", "faceIndex": "370782198709170246" }, "httpurl": "" } -
应答报文示例
{ "result": {}, "error_msg": "成功", "error_code": "0", "xybw": "{\"code\":\"0000\",\"msg\":\"成功\",\"content\":null}" }
人脸认证
- 接口：POST esb_wl_test/service/zh/getFaceRecognition
-
请求报文示例
{ "params": { "name": "小静", "faceIndex": "370782198709170246", "image": "图片的base64" }, "httpurl": "" } -
应答报文示例
-
活体检测失败
{ "result": { "data": [] }, "error_msg": "活体检测失败", "error_code": "0305070007", "xybw": "{\"code\":\"0305070007\",\"msg\":\"活体检测失败\",\"content\":\"100939956931338240\"}" } -
未发签约接口直接发人脸识别接口返回
{ "result": { "data": [] }, "error_msg": "用户未签署协议", "error_code": "0305070013", "xybw": "{\"code\":\"0305070013\",\"msg\":\"用户未签署协议\",\"content\":null}" } -
测试库不存在的数据
{ "result": { "data": [] }, "error_msg": "照片不存在", "error_code": "0305070010", "xybw": "{\"code\":\"0305070010\",\"msg\":\"照片不存在\",\"content\":\"100948140225985331\"}" } -
成功示例报文
{ "result": { "data": 100948035164571648 }, "error_msg": "成功", "error_code": "0", "xybw": "{\"code\":\"0000\",\"msg\":\"成功\",\"content\":\"100948035164571648\"}" }
-