文档中心
查看文档
示例代码
API调试
接入技术服务
社保卡识别
功能描述
社保卡识别。
请求URL
https://api.textin.com/robot/v1.0/api/social_security_card
HTTP请求方法
HTTP POST
请求头说明(Request Header)
请在HTTP请求中添加以下自定义Header。
| header 名 | 值 |
|---|---|
| x-ti-app-id | 请登录后前往 “工作台-账号设置-开发者信息” 查看 x-ti-app-id |
| x-ti-secret-code | 请登录后前往 “工作台-账号设置-开发者信息” 查看 x-ti-secret-code |
请求体说明(Request Body)
支持以下两种请求格式
1. Content-Type: application/octet-stream
要上传的图片,目前支持jpg, png, bmp, pdf, tiff, 单帧gif等大部分格式.
请注意,请求体的数据格式为本地文件的二进制流,非 FormData 或其他格式。文件大小不超过 10M,图像宽高须介于 20 和 10000(像素)之间。
2. Content-Type: text/plain
请求体的数据格式为文本,内容为在线文件的URL链接(支持http以及https协议)。在线文件大小不超过 10M,图像宽高须介于 20 和 10000(像素)之间。
响应体说明 (Response Data)
Content-Type: application/json
JSON结构说明如下:
说明:所有接口响应中均包含字段 x_request_id(string类型),作为请求的唯一标识。
| 字段名 | 描述 |
|---|---|
| code | 错误码,详见“错误码说明” |
| message | 错误信息 |
| result | 结果信息 |
| + type | 证件类型, 当为other的时候,代表无法识别的图片 |
| + image_angle | 图片角度,指原图需要经过顺时针旋转多少度,才能得到正方向的图片 |
| + rotated_image_width | 正方向时图片的宽 |
| + rotated_image_height | 正方向时图片高 |
| + item_list | 识别结果 |
| ++ key | 识别的字段 |
| ++ value | 识别的字段的值 |
| ++ description | 识别的字段中文描述 |
| ++ position | 识别的value在原图中的坐标,是个长度为8的数组 [0,1,2,3,4,5,6,7],(0, 1) 左上角坐标,(2, 3) 右上角坐标,(4, 5) 左下角坐标,(6, 7) 右下角坐标 |
item_list 中识别字段的说明
| 字段名 | 描述 |
|---|---|
| name | 姓名 |
| social_security_card_number | 号码(芯片下方) |
| card_number | 卡号 |
| issue_date | 发卡日期 |
| social_security_number | 社会保障号码 |