概述
1. 接口描述
接口请求域名: ocr.tencentcloudapi.com 。
本接口支持中国港澳台地区以及其他国家、地区的护照识别。识别字段包括护照ID、姓名、出生日期、性别、有效期、发行国、国籍,具备护照人像照片的裁剪功能和翻拍、复印件告警功能。
默认接口请求频率限制:5次/秒。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
Action | 是 | String | 公共参数,本接口取值:MLIDPassportOCR。 |
Version | 是 | String | 公共参数,本接口取值:2018-11-19。 |
Region | 是 | String | 公共参数,详见产品支持的 地域列表,本接口仅支持其中的: ap-guangzhou, ap-singapore |
ImageBase64 | 是 | String | 图片的 Base64 值。要求图片经Base64编码后不超过 7M,分辨率建议500*800以上,支持PNG、JPG、JPEG、BMP格式。建议卡片部分占据图片2/3以上。 |
RetImage | 否 | Boolean | 是否返回图片,默认false |
2. 输出参数
参数名称 | 类型 | 描述 |
---|---|---|
ID | String | 护照ID |
Name | String | 姓名 |
DateOfBirth | String | 出生日期 |
Sex | String | 性别(F女,M男) |
DateOfExpiration | String | 有效期 |
IssuingCountry | String | 发行国 |
Nationality | String | 国籍 |
Warn | Array of Integer | 告警码-9103 证照翻拍告警 -9102 证照复印件告警 -9106 证件遮挡告警 |
Image | String | 证件图片 |
AdvancedInfo | String | 扩展字段: { ID:{ Confidence:0.9999 }, Name:{ Confidence:0.9996 } } |
RequestId | String | 唯一请求 ID, 每次请求都会返回。 定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 护照识别(港澳台地区及境外护照)示例代码前往调试工具
输入示例
https://ocr.tencentcloudapi.com/?Action=MLIDPassportOCR
&ImageBase64=base64编码
&<公共请求参数>
输出示例
{
"Response": {
"ID": "E6918C",
"Name": "LIM HEG CHUN STEE",
"IssuingCountry": "SGP",
"Nationality": "SGP",
"DateOfBirth": "",
"Sex": "M",
"DateOfExpiration": "230414",
"Warn": [],
"Image": "",
"AdvancedInfo": "{"IssuingCountry":{"Confidence":"0.9500"},"Name":{"Confidence":"0.9500"},"ID":{"Confidence":"0.9500"},"Nationality":{"Confidence":"0.9500"},"Sex":{"Confidence":"0.9500"},"DateOfExpiration":{"Confidence":"0.9500"}}",
"RequestId": "0ee989d3-d064-45ec-bccb-63f5064247b4"
}
}
5. 错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
错误码 | 描述 |
---|---|
FailedOperation.DownLoadError | 文件下载失败。 |
FailedOperation.ImageDecodeFailed | 图片解码失败。 |
FailedOperation.OcrFailed | OCR识别失败。 |
FailedOperation.UnKnowError | 未知错误。 |
FailedOperation.UnOpenError | 服务未开通。 |
InvalidParameterValue.InvalidParameterValueLimit | 参数值错误。 |
LimitExceeded.TooLargeFileError | 文件内容太大。 |
代码生成
from tencentcloud.common import credential
from tencentcloud.common.profile.client_profile import ClientProfile
from tencentcloud.common.profile.http_profile import HttpProfile
from tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKException
from tencentcloud.ocr.v20181119 import ocr_client, models
try:
cred = credential.Credential("AKIDLTv7zh8sjeNrV9vQedc4mO", "oZMm0TiV4atwbHtFG3")
httpProfile = HttpProfile()
httpProfile.endpoint = "ocr.tencentcloudapi.com"
clientProfile = ClientProfile()
clientProfile.httpProfile = httpProfile
client = ocr_client.OcrClient(cred, "ap-guangzhou", clientProfile)
req = models.MLIDPassportOCRRequest()
params = '{"ImageBase64":"12"}'
req.from_json_string(params)
resp = client.MLIDPassportOCR(req)
print(resp.to_json_string())
except TencentCloudSDKException as err:
print(err)
在线调用
响应结果
{
"Response": {
"ID": "340000230",
"Name": "TRAVELER MR",
"IssuingCountry": "USA",
"Nationality": "USA",
"DateOfBirth": "500101",
"Sex": "M",
"DateOfExpiration": "110123",
"Warn": [
-9106
],
"Image": "",
"AdvancedInfo": "{"IssuingCountry":{"Confidence":"0.9500"},"Name":{"Confidence":"0.9500"},"ID":{"Confidence":"0.9500"},"Nationality":{"Confidence":"0.9500"},"DateOfBirth":{"Confidence":"0.9500"},"Sex":{"Confidence":"0.9500"},"DateOfExpiration":{"Confidence":"0.9500"}}",
"RequestId": "2dc6276e-35dd-4820-a553-6c2bbde79929"
}
}
响应头
Server:nginx
Date:Fri, 11 Sep 2020 01:44:25 GMT
Content-Type:application/json
Content-Length:544
Connection:close
Image To Base64 | Base64 To Image
import base64
from PIL import Image
import io
def picture2base64(path):
with open(path,'rb') as file_image:
img_b64encode = base64.b64encode(file_image.read())
print(img_b64encode)
with open('tmp.txt','wb') as file:
file.write(img_b64encode)
def base2picture(path):
with open(path,'rb') as img_file:
img_b64encode = base64.b64encode(img_file.read())
print(img_b64encode)
img_b64decode = base64.b64decode(img_b64encode)
image = io.BytesIO(img_b64decode)
img = Image.open(image)
img.show()
if __name__ == '__main__':
src_path = "C:\UsersAdminDesktop\0.jpg"
picture2base64(path=src_path)
base2picture(path=src_path)
最后
以上就是包容白羊为你收集整理的护照识别(港澳台地区及境外护照)API 及 BASE64图片加密的全部内容,希望文章能够帮你解决护照识别(港澳台地区及境外护照)API 及 BASE64图片加密所遇到的程序开发问题。
如果觉得靠谱客网站的内容还不错,欢迎将靠谱客网站推荐给程序员好友。
本图文内容来源于网友提供,作为学习参考使用,或来自网络收集整理,版权属于原作者所有。
发表评论 取消回复