阿联酋银行卡识别
功能介绍
识别阿联酋银行卡上的关键文字信息，并将识别的结构化结果返回给用户。
前提条件
在使用阿联酋银行卡识别之前，需要您完成服务申请和认证鉴权，具体操作流程请参见开通服务和认证鉴权章节。
用户首次使用需要先开通服务。服务只需要开通一次即可，后面使用时无需再次申请。如未开通服务，调用服务时会提示ModelArts.4204报错，请在调用服务前先进入控制台开通服务，并注意开通服务区域与调用服务的区域保持一致。
URI
POST https://{endpoint}/v2/{project_id}/ocr/bankcard
|
参数 |
是否必选 |
说明 |
|---|---|---|
|
endpoint |
是 |
指定承载REST服务端点的服务器域名或IP，不同服务不同区域的endpoint不同，您可以从终端节点中获取。 |
|
project_id |
是 |
项目ID，您可以从获取账号ID和项目ID中获取。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。 用于获取操作API的权限。获取Token接口响应消息头中X-Subject-Token的值即为Token。 |
|
Content-Type |
是 |
String |
发送的实体的MIME类型，参数值为“application/json”。 |
|
参数 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
|
image |
否，该参数与url二选一 |
String |
图片的Base64编码，要求Base64编码后大小不超过10MB。 图片最短边不小于15px，最长边不超过8192px，支持JPG、PNG、BMP、TIFF格式。 图片Base64编码示例如/9j/4AAQSkZJRgABAg...，带有多余前缀会产生The image format is not supported报错。 |
|
url |
否，该参数与image二选一 |
String |
图片的URL路径。
说明：
|
响应参数
根据识别的结果，可能有不同的HTTP响应状态码（status code），状态码和响应参数说明如下。
状态码： 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
result |
Object |
调用结果。 调用失败时不返回此字段。 |
|
参数 |
参数类型 |
说明 |
|---|---|---|
|
type |
String |
银行卡的类别：
|
|
card_number |
String |
银行卡号 |
|
issue_date |
String |
发卡日期 |
|
expiry_date |
String |
有效期 |
|
card_holder |
String |
持卡人姓名 |
|
confidence |
Object |
字段的置信度，取值范围0~1。 置信度越大，本次识别的字段的可靠性越高，在统计意义上，置信度越大，准确率越高。 置信度由算法给出，不直接等价于字段的准确率。 |
状态码： 400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
调用失败时的错误码，具体请参见错误码。 调用成功时不返回此字段。 |
|
error_msg |
String |
调用失败时返回的错误信息。 调用成功时不返回此字段。 |
请求示例
- 请求示例（方式一：使用图片的Base64编码）
POST https://ocr.ae-ad-1.g42cloud.com/v2/{project_id}/ocr/bankcard Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "image":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAA..." }
- 请求示例（方式二：使用图片URL）
POST https://ocr.ae-ad-1.g42cloud.com/v2/{project_id}/ocr/ bankcard Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "url":"https://BucketName.obs.xxxx.com/ObjectName" }
响应示例
状态码：200
成功响应示例
{
"result": {
"bank_name": "",
"card_number": "6225 7687 0000 8243",
"issue_date": "12/10",
"expiry_date": "12/20",
"type": "Visa",
"card_holder": "SALIM RASHID",
"confidence": {
"bank_name": 0.0,
"card_number": 0.8562,
"issue_date": 0.9962,
"expiry_date": 0.9256,
"type": 0.9012,
"card_holder": 0.8452,
}
}
}
状态码：400
失败响应示例
{
"error_code": "AIS.0103",
"error_msg": "The image size does not meet the requirements"
}
错误码
错误码请参见错误码。
