{"componentChunkName":"component---src-templates-acg-portal-new-template-tsx","path":"/Xmhaazmyd","result":{"data":{"markdownRemark":{"html":"

接口描述

\n

支持对二代居民身份证正反面所有8个字段进行结构化识别，包括姓名、性别、民族、出生日期、住址、身份证号、签发机关、有效期限，识别准确率超过99%；同时支持身份证正面头像检测，并返回头像切片的base64编码及位置信息。

\n

同时，支持对用户上传的身份证图片进行图像质量和风险检测，是否存在正反颠倒、模糊、欠曝、过曝等质量问题，可识别图片是否为复印件或临时身份证，是否被翻拍、截屏或编辑，是否存在四角不完整、头像或关键字段被遮挡。

\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
增值能力详情
裁剪能力头像检测与切片：返回头像切片的base64编码及位置信息
身份证检测与切片：返回身份证的base64编码及位置信息（去掉证件外围多余背景、自动矫正拍摄角度）
质量检测 身份证图片模糊检测
身份证关键字段反光或过曝光
身份证图片较暗或欠曝光
身份证边框/四角不完整告警
身份证头像或关键字段被遮挡/马赛克告警
风险检测 身份证复印件/扫描件告警
临时身份证告警
身份证翻拍告警
身份证截屏告警
身份证PS编辑告警
身份证证号不合法告警
身份证证号和出生日期、性别信息不一致告警
\n
\n

视频教程请参见 身份证识别API调用教程（视频版）

\n
\n

在线调试

\n

您可以在 示例代码中心 中调试该接口，可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。

\n

请求说明

\n

请求示例

\n

HTTP 方法：POST

\n

请求URL： https://aip.baidubce.com/rest/2.0/ocr/v1/idcard

\n

URL参数：

\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数值
access_token通过API Key和Secret Key获取的access_token,参考“Access Token获取”
\n

Header如下：

\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数值
Content-Typeapplication/x-www-form-urlencoded
\n

Body中放置请求参数，参数详情如下：

\n

请求参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数是否必选类型可选值范围说明
image和url二选一string-图像数据，base64编码后进行urlencode，需去掉编码头（data:image/jpeg;base64, ）
要求base64编码和urlencode后大小不超过8M，最短边至少15px，最长边最大8192px，支持jpg/jpeg/png/bmp格式
url和image二选一string-图片完整URL，URL长度不超过1024字节，URL对应的图片base64编码后大小不超过8M，最短边至少15px，最长边最大8192px，支持jpg/jpeg/png/bmp格式，当image字段存在时url字段失效
请注意关闭URL防盗链
id_card_side是stringfront/back-front：身份证含照片的一面
-back：身份证带国徽的一面
自动检测身份证正反面，如果传参指定方向与图片相反，支持正常识别，返回参数image_status字段为\"reversed_side\"
detect_ps否stringtrue/false是否检测上传的身份证被PS，默认不检测。可选值：
-true：检测；
- false：不检测
detect_risk否stringtrue/false是否开启身份证风险类型（身份证复印件/扫描件、临时身份证、身份证翻拍/截屏、修改过的身份证）检测功能，默认不开启，即：false。
- true：开启，请查看返回参数risk_type；
- false：不开启
detect_quality否stringtrue/false是否开启身份证质量类型（清晰模糊、边框/四角不完整、头像或关键字段被遮挡/马赛克）检测功能，默认不开启，即：false。
- true：开启，请查看返回参数card_quality；
- false：不开启
detect_photo否stringtrue/false是否检测头像内容，默认不检测，即：false。
- true：检测头像并返回头像的 base64 编码及位置信息；
- false：不检测
detect_card否stringtrue/false是否检测身份证进行裁剪，默认不检测，即：false。
- true：检测身份证并返回证照的 base64 编码及位置信息；
- false：不检测
detect_direction否stringtrue/false是否检测上传的身份证图片方向，默认不检测，即：false。
- true：检测；
- false：不检测
detect_screenshot否stringtrue/false是否细分输出截屏风险类型，当 detect_risk =ture 时，该参数才生效。默认不开启，即：false。
- true：开启，将在 risk_type 细分输出 screenshot 截屏类型；
- false：不开启，risk_type 将合并 screenshot 截屏到 screen 翻拍类型输出
\n

请求代码示例

\n

提示一：使用示例代码前，请记得替换其中的示例Token、图片地址或Base64信息。

\n

提示二：部分语言依赖的类或库，请在代码注释中查看下载地址。

\n\n
\n
\n
\n
\n \n \n Bash\n \n \n \n Python\n \n \n \n JAVA\n \n \n \n C++\n \n \n \n PHP\n \n \n \n C#\n \n \n
\n
\n \n
\n
\n \n \n
\n 
1curl -i -k 'https://aip.baidubce.com/rest/2.0/ocr/v1/idcard?access_token=【调用鉴权接口获取的token】' --data 'id_card_side=front&image=【图片Base64编码，需UrlEncode】' -H 'Content-Type:application/x-www-form-urlencoded'
\n
\n \n \n
\n 
1# encoding:utf-8\n2\n3import requests\n4import base64\n5\n6'''\n7身份证识别\n8'''\n9\n10request_url = \"https://aip.baidubce.com/rest/2.0/ocr/v1/idcard\"\n11# 二进制方式打开图片文件\n12f = open('[本地文件]', 'rb')\n13img = base64.b64encode(f.read())\n14\n15params = {\"id_card_side\":\"front\",\"image\":img}\n16access_token = '[调用鉴权接口获取的token]'\n17request_url = request_url + \"?access_token=\" + access_token\n18headers = {'content-type': 'application/x-www-form-urlencoded'}\n19response = requests.post(request_url, data=params, headers=headers)\n20if response:\n21    print (response.json())
\n
\n \n \n
\n 
1package com.baidu.ai.aip;\n2\n3import com.baidu.ai.aip.utils.Base64Util;\n4import com.baidu.ai.aip.utils.FileUtil;\n5import com.baidu.ai.aip.utils.HttpUtil;\n6\n7import java.net.URLEncoder;\n8\n9/**\n10* 身份证识别\n11*/\n12public class Idcard {\n13\n14    /**\n15    * 重要提示代码中所需工具类\n16    * FileUtil,Base64Util,HttpUtil,GsonUtils请从\n17    * https://ai.baidu.com/file/658A35ABAB2D404FBF903F64D47C1F72\n18    * https://ai.baidu.com/file/C8D81F3301E24D2892968F09AE1AD6E2\n19    * https://ai.baidu.com/file/544D677F5D4E4F17B4122FBD60DB82B3\n20    * https://ai.baidu.com/file/470B3ACCA3FE43788B5A963BF0B625F3\n21    * 下载\n22    */\n23    public static String idcard() {\n24        // 请求url\n25        String url = \"https://aip.baidubce.com/rest/2.0/ocr/v1/idcard\";\n26        try {\n27            // 本地文件路径\n28            String filePath = \"[本地文件路径]\";\n29            byte[] imgData = FileUtil.readFileByBytes(filePath);\n30            String imgStr = Base64Util.encode(imgData);\n31            String imgParam = URLEncoder.encode(imgStr, \"UTF-8\");\n32\n33            String param = \"id_card_side=\" + \"front\" + \"&image=\" + imgParam;\n34\n35            // 注意这里仅为了简化编码每一次请求都去获取access_token，线上环境access_token有过期时间， 客户端可自行缓存，过期后重新获取。\n36            String accessToken = \"[调用鉴权接口获取的token]\";\n37\n38            String result = HttpUtil.post(url, accessToken, param);\n39            System.out.println(result);\n40            return result;\n41        } catch (Exception e) {\n42            e.printStackTrace();\n43        }\n44        return null;\n45    }\n46\n47    public static void main(String[] args) {\n48        Idcard.idcard();\n49    }\n50}
\n
\n \n \n
\n 
1#include <iostream>\n2#include <curl/curl.h>\n3\n4// libcurl库下载链接：https://curl.haxx.se/download.html\n5// jsoncpp库下载链接：https://github.com/open-source-parsers/jsoncpp/\n6const static std::string request_url = \"https://aip.baidubce.com/rest/2.0/ocr/v1/idcard\";\n7static std::string idcard_result;\n8/**\n9 * curl发送http请求调用的回调函数，回调函数中对返回的json格式的body进行了解析，解析结果储存在全局的静态变量当中\n10 * @param 参数定义见libcurl文档\n11 * @return 返回值定义见libcurl文档\n12 */\n13static size_t callback(void *ptr, size_t size, size_t nmemb, void *stream) {\n14    // 获取到的body存放在ptr中，先将其转换为string格式\n15    idcard_result = std::string((char *) ptr, size * nmemb);\n16    return size * nmemb;\n17}\n18/**\n19 * 身份证识别\n20 * @return 调用成功返回0，发生错误返回其他错误码\n21 */\n22int idcard(std::string &json_result, const std::string &access_token) {\n23    std::string url = request_url + \"?access_token=\" + access_token;\n24    CURL *curl = NULL;\n25    CURLcode result_code;\n26    int is_success;\n27    curl = curl_easy_init();\n28    if (curl) {\n29        curl_easy_setopt(curl, CURLOPT_URL, url.data());\n30        curl_easy_setopt(curl, CURLOPT_POST, 1);\n31        curl_httppost *post = NULL;\n32        curl_httppost *last = NULL;\n33        curl_formadd(&post, &last, CURLFORM_COPYNAME, \"id_card_side\", CURLFORM_COPYCONTENTS, \"front\", CURLFORM_END);\n34        curl_formadd(&post, &last, CURLFORM_COPYNAME, \"image\", CURLFORM_COPYCONTENTS, \"【base64_img】\", CURLFORM_END);\n35\n36        curl_easy_setopt(curl, CURLOPT_HTTPPOST, post);\n37        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, callback);\n38        result_code = curl_easy_perform(curl);\n39        if (result_code != CURLE_OK) {\n40            fprintf(stderr, \"curl_easy_perform() failed: %s\\n\",\n41                    curl_easy_strerror(result_code));\n42            is_success = 1;\n43            return is_success;\n44        }\n45        json_result = idcard_result;\n46        curl_easy_cleanup(curl);\n47        is_success = 0;\n48    } else {\n49        fprintf(stderr, \"curl_easy_init() failed.\");\n50        is_success = 1;\n51    }\n52    return is_success;\n53}
\n
\n \n \n
\n 
1<?php\n2/**\n3 * 发起http post请求(REST API), 并获取REST请求的结果\n4 * @param string $url\n5 * @param string $param\n6 * @return - http response body if succeeds, else false.\n7 */\n8function request_post($url = '', $param = '')\n9{\n10    if (empty($url) || empty($param)) {\n11        return false;\n12    }\n13\n14    $postUrl = $url;\n15    $curlPost = $param;\n16    // 初始化curl\n17    $curl = curl_init();\n18    curl_setopt($curl, CURLOPT_URL, $postUrl);\n19    curl_setopt($curl, CURLOPT_HEADER, 0);\n20    // 要求结果为字符串且输出到屏幕上\n21    curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);\n22    curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);\n23    // post提交方式\n24    curl_setopt($curl, CURLOPT_POST, 1);\n25    curl_setopt($curl, CURLOPT_POSTFIELDS, $curlPost);\n26    // 运行curl\n27    $data = curl_exec($curl);\n28    curl_close($curl);\n29\n30    return $data;\n31}\n32\n33$token = '[调用鉴权接口获取的token]';\n34$url = 'https://aip.baidubce.com/rest/2.0/ocr/v1/idcard?access_token=' . $token;\n35$img = file_get_contents('[本地文件路径]');\n36$img = base64_encode($img);\n37$bodys = array(\n38    'id_card_side' => \"front\",\n39    'image' => $img\n40);\n41$res = request_post($url, $bodys);\n42\n43var_dump($res);
\n
\n \n \n
\n 
1using System;\n2using System.IO;\n3using System.Net;\n4using System.Text;\n5using System.Web;\n6\n7namespace com.baidu.ai\n8{\n9    public class Idcard\n10    {\n11        // 身份证识别\n12        public static string idcard()\n13        {\n14            string token = \"[调用鉴权接口获取的token]\";\n15            string host = \"https://aip.baidubce.com/rest/2.0/ocr/v1/idcard?access_token=\" + token;\n16            Encoding encoding = Encoding.Default;\n17            HttpWebRequest request = (HttpWebRequest)WebRequest.Create(host);\n18            request.Method = \"post\";\n19            request.KeepAlive = true;\n20            // 图片的base64编码\n21            string base64 = getFileBase64(\"[本地图片文件]\");\n22            String str = \"id_card_side=\" + \"front\" + \"&image=\" + HttpUtility.UrlEncode(base64);\n23            byte[] buffer = encoding.GetBytes(str);\n24            request.ContentLength = buffer.Length;\n25            request.GetRequestStream().Write(buffer, 0, buffer.Length);\n26            HttpWebResponse response = (HttpWebResponse)request.GetResponse();\n27            StreamReader reader = new StreamReader(response.GetResponseStream(), Encoding.Default);\n28            string result = reader.ReadToEnd();\n29            Console.WriteLine(\"身份证识别:\");\n30            Console.WriteLine(result);\n31            return result;\n32        }\n33\n34        public static String getFileBase64(String fileName) {\n35            FileStream filestream = new FileStream(fileName, FileMode.Open);\n36            byte[] arr = new byte[filestream.Length];\n37            filestream.Read(arr, 0, (int)filestream.Length);\n38            string baser64 = Convert.ToBase64String(arr);\n39            filestream.Close();\n40            return baser64;\n41        }\n42    }\n43}
\n
\n \n
\n
\n
\n \n

返回说明

\n

返回参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段是否必选类型说明
log_id是uint64唯一的log id，用于问题定位
words_result是object定位和识别结果
words_result_num是uint32识别结果数，表示words_result的元素个数
direction否int32图像方向，输入参数 detect_direction= true 时返回。
- - 1：未定义，
- 0：正向，
- 1：逆时针90度，
- 2：逆时针180度，
- 3：逆时针270度
image_status是stringnormal-识别正常
reversed_side-身份证正反面颠倒
non_idcard-上传的图片中不包含身份证
blurred-身份证模糊
other_type_card-其他类型证照
over_exposure-身份证关键字段反光或过曝
over_dark-身份证欠曝（亮度过低）
unknown-未知状态
card_ps否string输入参数 detect_ps = true 时，则返回该字段，判断身份证是否被PS，返回值：
- 0：正常，
- 1：PS，
- -1：无效
risk_type否string输入参数 detect_risk = true 时，则返回该字段识别身份证风险类型:
normal-正常身份证；
copy-复印件；
scan-扫描件；
temporary-临时身份证；
screen-翻拍；
screenshot-截屏（仅在开启 detect_screenshot 时返回）；
unknown-其他未知情况
edit_tool否string如果参数 detect_risk = true 时，则返回此字段。如果检测身份证被编辑过，该字段指定编辑软件名称，如:Adobe Photoshop CC 2014 (Macintosh),如果没有被编辑过则返回值无此参数
card_quality否object输入参数 detect_quality = true 时，则返回该字段识别身份证质量类型
+ IsClear否float质量类型，是否清晰，返回值包括：
- 1：清晰
- 0：不清晰
+ IsClear_propobility否float“是否清晰”质量类型对应的概率，值在0-1之间，值越大表示图像质量越好。默认阈值（仅为推荐值，建议按照实际业务场景，基于图片返回的具体概率值，自定义设置判断阈值）：当 IsClear_propobility 超过0.5时，对应 IsClear 返回1，低于0.5，则返回0
+ IsComplete否float质量类型，是否边框/四角完整，返回值包括：
- 1：边框/四角完整
- 0：边框/四角不完整
+ IsComplete_propobility否float“是否边框/四角完整”质量类型对应的概率，值在0-1之间，值越大表示图像质量越好。默认阈值（仅为推荐值，建议按照实际业务场景，基于图片返回的具体概率值，自定义设置判断阈值）：当 IsComplete_propobility 超过0.5时，对应 IsComplete 返回1，低于0.5，则返回0
+ IsNoCover否float质量类型，是否头像、关键字段无遮挡/马赛克，返回值包括：
- 1：头像、关键字段无遮挡/马赛克
- 0：头像、关键字段有遮挡/马赛克
+ IsNoCover_propobility否float“是否头像、关键字段无遮挡/马赛克”质量类型对应的概率，值在0-1之间，值越大表示图像质量越好。默认阈值（仅为推荐值，建议按照实际业务场景，基于图片返回的具体概率值，自定义设置判断阈值）：当 IsNoCover_propobility 超过0.3时，对应IsNoCover 返回1，低于0.3，则返回0
photo否string当请求参数 detect_photo = true时返回，头像切图的 base64 编码（无编码头，需自行处理）
photo_location否object当请求参数 detect_photo = true时返回，头像的位置信息（坐标0点为左上角）
card_image否string当请求参数 detect_card = true时返回，身份证裁剪切图的 base64 编码（无编码头，需自行处理）
card_location否object当请求参数 detect_card = true时返回，身份证裁剪切图的位置信息（坐标0点为左上角）
idcard_number_type是int用于校验身份证号码、性别、出生是否一致，输出结果及其对应关系如下：
- 1： 身份证正面所有字段全为空
0： 身份证证号不合法，此情况下不返回身份证证号
1： 身份证证号和性别、出生信息一致
2： 身份证证号和性别、出生信息都不一致
3： 身份证证号和出生信息不一致
4： 身份证证号和性别信息不一致
+ location是array[]位置数组（坐标0点为左上角）
++ left是uint32表示定位位置的长方形左上顶点的水平坐标
++ top是uint32表示定位位置的长方形左上顶点的垂直坐标
++ width是uint32表示定位位置的长方形的宽度
++ height是uint32表示定位位置的长方形的高度
+ words否string识别结果字符串
\n

返回示例（身份证头像面）

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2    \"log_id\": \"1559208562721579319\",\n3    \"direction\": 0,\n4    \"image_status\": \"normal\",\n5    \"photo\": \"/9j/4AAQSkZJRgABA......\",\n6    \"photo_location\": {\n7        \"width\": 1189,\n8        \"top\": 638,\n9        \"left\": 2248,\n10        \"height\": 1483\n11    },\n12    \"card_image\": \"/9j/4AAQSkZJRgABA......\",\n13    \"card_location\": {\n14        \"top\": 328,\n15        \"left\": 275,\n16        \"width\": 1329,\n17        \"height\": 571\n18    },\n19    \"words_result\": {\n20        \"住址\": {\n21            \"location\": {\n22                \"left\": 267,\n23                \"top\": 453,\n24                \"width\": 459,\n25                \"height\": 99\n26            },\n27            \"words\": \"南京市江宁区弘景大道3889号\"\n28        },\n29        \"公民身份号码\": {\n30            \"location\": {\n31                \"left\": 443,\n32                \"top\": 681,\n33                \"width\": 589,\n34                \"height\": 45\n35            },\n36            \"words\": \"330881199904173914\"\n37        },\n38        \"出生\": {\n39            \"location\": {\n40                \"left\": 270,\n41                \"top\": 355,\n42                \"width\": 357,\n43                \"height\": 45\n44            },\n45            \"words\": \"19990417\"\n46        },\n47        \"姓名\": {\n48            \"location\": {\n49                \"left\": 267,\n50                \"top\": 176,\n51                \"width\": 152,\n52                \"height\": 50\n53            },\n54            \"words\": \"伍云龙\"\n55        },\n56        \"性别\": {\n57            \"location\": {\n58                \"left\": 269,\n59                \"top\": 262,\n60                \"width\": 33,\n61                \"height\": 52\n62            },\n63            \"words\": \"男\"\n64        },\n65        \"民族\": {\n66            \"location\": {\n67                \"left\": 492,\n68                \"top\": 279,\n69                \"width\": 30,\n70                \"height\": 37\n71            },\n72            \"words\": \"汉\"\n73        }\n74    },\n75    \"words_result_num\": 6\n76}
\n
\n
\n
\n \n

返回示例（身份证国徽面）

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2    \"words_result\": {\n3        \"失效日期\": {\n4            \"words\": \"20390711\",\n5            \"location\": {\n6                \"top\": 445,\n7                \"left\": 523,\n8                \"width\": 153,\n9                \"height\": 38\n10            }\n11        },\n12        \"签发机关\": {\n13            \"words\": \"陆丰市公安局\",\n14            \"location\": {\n15                \"top\": 377,\n16                \"left\": 339,\n17                \"width\": 195,\n18                \"height\": 38\n19            }\n20        },\n21        \"签发日期\": {\n22            \"words\": \"20190606\",\n23            \"location\": {\n24                \"top\": 445,\n25                \"left\": 343,\n26                \"width\": 152,\n27                \"height\": 38\n28            }\n29        }\n30    },\n31    \"log_id\": \"1559208562721579328\",\n32    \"words_result_num\": 3,\n33    \"error_code\": 0,\n34    \"image_status\": \"normal\"\n35}
\n
\n
\n
\n \n

AES加密

\n

您可以选择使用AES加密来请求本身份证识别接口，支持对身份证图片及识别结果进行加密后传输，示意图如下：

\n

\"image.png\"\n

\n
    \n
  1. 在百度云控制台「文字识别-应用列表-管理」中获取您的AES Key
    2. \n
  2. 使用AES Key对将要识别的图片进行加密
    3. \n
  3. 将加密后的图片传入接口，请求参数AESEncry设置为true
    4. \n
  4. 接口返回加密后的识别结果，使用AES Key进行解密，得到明文识别结果\n
    5. \n
\n

使用AES加密不影响身份证识别接口支持的质量检测、风险检测等其他能力，也不影响识别效果。

\n

请求说明

\n

请求示例

\n

HTTP 方法：POST

\n

请求URL： https://aip.baidubce.com/rest/2.0/ocr/v1/idcard

\n

URL参数：

\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数值
access_token通过API Key和Secret Key获取的access_token,参考“Access Token获取”
\n

Header如下：

\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数值
Content-Typeapplication/x-www-form-urlencoded
\n

Body中放置请求参数，参数详情如下：

\n

请求参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数是否必选类型可选值范围说明
image是string-AES加密后的图像数据，请对加密图片进行base64编码后进行urlencode，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/jpeg/png/bmp格式
AESEncry是stringtrue/false使用AES加密请传true
id_card_side是stringfront/back-front：身份证含照片的一面
-back：身份证带国徽的一面
自动检测身份证正反面，如果传参指定方向与图片相反，支持正常识别，返回参数image_status字段为\"reversed_side\"
detect_direction否string-此参数新版本无需传，支持自动检测图像旋转角度
detect_risk否stringtrue/false是否开启身份证风险类型(身份证复印件/扫描件、临时身份证、身份证翻拍/截屏、修改过的身份证)功能，默认不开启，即：false。
- true：开启，请查看返回参数risk_type；
- false：不开启
detect_photo否stringtrue/false是否检测头像内容，默认不检测，即：false。
- true：检测头像并返回头像的 base64 编码及位置信息；
- false：不检测
detect_screenshot否stringtrue/false是否细分输出截屏风险类型，当 detect_risk =ture 时，该参数才生效。默认不开启，即：false。
- true：开启，risk_type 将细分输出 screenshot 截屏类型；
- false：不开启，risk_type 将合并 screenshot 截屏到 screen 翻拍类型输出
\n

请求代码示例

\n

提示一：使用示例代码前，请记得替换其中的示例Token、图片地址或Base64信息。

\n

提示二：部分语言依赖的类或库，请在代码注释中查看下载地址。

\n\n
\n
\n
\n
\n \n \n Python\n \n \n \n JAVA\n \n \n \n C++\n \n \n \n PHP\n \n \n \n C#\n \n \n
\n
\n \n
\n
\n \n \n
\n 
1# -*- coding: utf-8 -*-\n2#\n3from urllib import urlencode\n4import base64\n5from urllib import unquote\n6import requests\n7import json\n8from Crypto.Cipher import AES\n9import binascii\n10\n11ak = \"ak\"\n12# 文字识别应用的API Key\n13sk = \"sk\"\n14# 文字识别应用的Secret Key\n15\n16aes = 'res'\n17# aes key 从控制台 文字识别-应用列表-应用管理 获取\n18\n19class AESCipher:\n20    def __init__(self, key):\n21        self.key = self.get_key(key)\n22\n23    def get_key(self, key):\n24        st = bytearray()\n25        for s in key:\n26            st.append(int(s, 16))\n27        str = st.decode('utf-8')\n28        return str\n29\n30    def pad(self, text):\n31        # 填充方法，加密内容必须为16字节的倍数\n32        text_length = len(text)\n33        amount_to_pad = AES.block_size - (text_length % AES.block_size)\n34        if amount_to_pad == 0:\n35            amount_to_pad = AES.block_size\n36        pad = chr(amount_to_pad)\n37        return text + pad * amount_to_pad\n38\n39    def __unpad(self, text):\n40        # 截取填充的字符\n41        pad = ord(text[-1])\n42        return text[:-pad]\n43\n44        # 加密函数\n45\n46    def encrypt(self, raw):\n47        raw = self.pad(raw)\n48        cipher = AES.new(self.key, AES.MODE_ECB)\n49        return base64.b64encode(cipher.encrypt(raw))\n50\n51    def decrypt(self, enc):\n52        \"\"\"\n53        解密方法\n54        :param enc: base64编码的密文 str\n55        :return: 解密后的明文 str\n56        \"\"\"\n57        cipher = AES.new(self.key, AES.MODE_ECB)\n58        return self.__unpad(cipher.decrypt(enc))\n59\n60\n61def get_accessToken():\n62    url = \"https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id={ak}&client_secret={sk}\".format(\n63        ak=ak, sk=sk)\n64    response = requests.get(url)\n65    return response.json()['access_token']\n66\n67\n68encryptor = AESCipher(aes)\n69\n70token = get_accessToken()\n71# 改成接口文档里的url\n72nameurl = \"https://aip.baidubce.com/rest/2.0/ocr/v1/idcard\"\n73url = nameurl + \"?access_token={token}\".format(token=token)\n74print url\n75\n76f = open('resources/my.jpg', 'rb')\n77d = f.read()\n78r_data = encryptor.encrypt(d)\n79# 构造请求数据格式\n80data = {}\n81data['image'] = r_data\n82data['id_card_side'] = 'front'\n83data['AESEncry'] = 'true'\n84headers = {'content-type': 'application/x-www-form-urlencoded'}\n85\n86res = requests.post(url=url, data=data, headers=headers)\n87#res= json.dumps(res.content, ensure_ascii=False)\n88data=json.loads(res.content)\n89result=encryptor.decrypt(base64.b64decode(data['result']))\n90print result
\n
\n \n \n
\n 
1package AES;\n2\n3import com.alibaba.fastjson.JSONObject;\n4import javax.crypto.Cipher;\n5import javax.crypto.spec.SecretKeySpec;\n6import java.net.URLEncoder;\n7import java.util.Base64;\n8\n9public class Idcard {\n10\n11    /**\n12     * 重要提示代码中所需工具类\n13     * FileUtil,HttpUtil请从\n14     * https://ai.baidu.com/file/658A35ABAB2D404FBF903F64D47C1F72\n15     * https://ai.baidu.com/file/544D677F5D4E4F17B4122FBD60DB82B3\n16     * 下载\n17     */\n18\n19    // 请求url\n20    static String url = \"https://aip.baidubce.com/rest/2.0/ocr/v1/idcard\";\n21\n22    // aes key 从console控制台获取\n23    static String aesKey = \"[16位 aeskey]\";\n24\n25    static byte[] originAesKey = null;\n26\n27    public static String idcard() {\n28        try {\n29            // 本地文件路径\n30            String filePath = \"[本地文件路径]\";\n31            byte[] imgData = FileUtil.readFileByBytes(filePath);\n32\n33            String imgStr = encryptImg(aesKey, imgData);\n34\n35            String imgParam = URLEncoder.encode(imgStr, \"UTF-8\");\n36\n37            String param = \"id_card_side=\" + \"front\" +\n38                    \"&image=\" + imgParam +\n39                    \"&AESEncry=\" + true ;\n40\n41            String accessToken = \"[access token]\";\n42\n43            String encryptResult = HttpUtil.post(url, accessToken, param);\n44\n45            String decryptResult = parseResult(encryptResult);\n46\n47            return decryptResult;\n48        } catch (Exception e) {\n49            e.printStackTrace();\n50        }\n51        return null;\n52    }\n53\n54    /**\n55     * 加密图片\n56     *\n57     * @param aesKey\n58     * @param imgData\n59     * @return\n60     * @throws Exception\n61     */\n62    private static String encryptImg(String aesKey, byte[] imgData) throws Exception {\n63        originAesKey = AesKeyUtil.parseAesKey(aesKey);\n64        byte[] encImgBytes = AesUtil.encrypt(imgData, originAesKey);\n65        String imgStr = Base64Util.encodeBase64(encImgBytes);\n66        return imgStr;\n67    }\n68\n69    /**\n70     * 解密结果\n71     *\n72     * @param encryptResult\n73     * @return\n74     * @throws Exception\n75     */\n76    private static String parseResult(String encryptResult) throws Exception {\n77        JSONObject obj = JSONObject.parseObject(encryptResult);\n78        String result = obj.getString(\"result\");\n79        byte[] arr = Base64Util.decodeBase64(result);\n80        String decryptResult = new String(AesUtil.decrypt(arr, originAesKey));\n81        return decryptResult;\n82    }\n83\n84    public static void main(String[] args) {\n85        Idcard.idcard();\n86    }\n87\n88\n89    static class AesKeyUtil {\n90        private static final String HEX = \"0123456789abcdef\";\n91\n92        /**\n93         * 获得原生的128位的aeskey\n94         * 因为一个byte位8位最后生成的byte数组长度为16\n95         * <p>\n96         * 16 * 8 = 128\n97         *\n98         * @param hex\n99         * @return\n100         */\n101        public static byte[] parseAesKey(String hex) throws Exception {\n102            char[] data = hex.toCharArray();\n103            if (data.length != 16) {\n104                throw new Exception(\" ase key illegal \");\n105            }\n106            return decode(hex.toCharArray());\n107        }\n108\n109        private static byte[] decode(char[] data) throws IllegalArgumentException {\n110            int len = data.length;\n111\n112            byte[] out = new byte[len];\n113\n114            for (int i = 0; i < len; i++) {\n115                int f = toDigit(data[i]);\n116                out[i] = (byte) (f);\n117            }\n118            return out;\n119        }\n120\n121        private static int toDigit(char ch) {\n122            return HEX.indexOf(ch);\n123        }\n124    }\n125\n126    static class AesUtil {\n127\n128        private static final String ALGORITHM = \"AES\";\n129\n130        private static final String ALGORITHM_STR = \"AES/ECB/PKCS5Padding\";\n131\n132        /**\n133         * aes 加密\n134         */\n135        private static byte[] encrypt(byte[] src, byte[] aesKey) throws Exception {\n136            Cipher cipher = getCipher(aesKey, Cipher.ENCRYPT_MODE);\n137            byte[] ret = cipher.doFinal(src);\n138            return ret;\n139        }\n140\n141        /**\n142         * aes 解密\n143         */\n144        public static byte[] decrypt(byte[] src, byte[] aesKey) throws Exception {\n145            Cipher cipher = getCipher(aesKey, Cipher.DECRYPT_MODE);\n146            byte[] original = cipher.doFinal(src);\n147            return original;\n148        }\n149\n150        private static Cipher getCipher(byte[] aesKey, int mode) throws Exception {\n151            SecretKeySpec secretKeySpec = new SecretKeySpec(aesKey, ALGORITHM);\n152            Cipher cipher = Cipher.getInstance(ALGORITHM_STR);\n153            cipher.init(mode, secretKeySpec);\n154            return cipher;\n155        }\n156    }\n157\n158    static class Base64Util {\n159\n160        private static Base64.Encoder ENCODER = Base64.getEncoder();\n161\n162        // base64 加密\n163        private static Base64.Decoder DECODER = Base64.getDecoder();\n164\n165        /**\n166         * base64加密\n167         *\n168         * @param arr\n169         * @return\n170         */\n171        private static String encodeBase64(byte[] arr) {\n172            String base64 = null;\n173            try {\n174                base64 = ENCODER.encodeToString(arr);\n175            } catch (Exception e) {\n176            }\n177            return base64;\n178        }\n179\n180        /**\n181         * base64解密\n182         *\n183         * @param str\n184         * @return\n185         */\n186        public static byte[] decodeBase64(String str) {\n187            byte[] encodeBase64 = new byte[0];\n188            try {\n189                encodeBase64 = DECODER.decode(str);\n190            } catch (Exception e) {\n191            }\n192            return encodeBase64;\n193        }\n194    }\n195}
\n
\n \n \n
\n 
1#include <iostream>\n2#include <map>\n3#include <curl/curl.h>\n4#include <cryptopp/aes.h>\n5#include <cryptopp/filters.h>\n6#include \"json/json.h\"\n7#include \"aip/base/base64.h\"\n8#include \"cryptopp/hex.h\"\n9#include \"openssl/aes.h\"\n10#include <openssl/evp.h>\n11#include <fstream>\n12\n13#define KEY_SIZE_16B            16\n14#define KEY_SIZE_24B            24\n15#define KEY_SIZE_32B            32\n16\n17using CryptoPP::HexEncoder;\n18using CryptoPP::HexDecoder;\n19\n20using CryptoPP::StringSource;\n21\n22// libcurl库下载链接：https://curl.haxx.se/download.html\n23// jsoncpp库下载链接：https://github.com/open-source-parsers/jsoncpp/\n24//const static std::string request_url = \"https://aip.baidubce.com/rest/2.0/ocr/v1/idcard\";\n25//获取token\n26inline size_t onWriteData(void *buffer, size_t size, size_t nmemb, void *userp) {\n27    std::string *str = dynamic_cast<std::string *>((std::string *) userp);\n28    str->append((char *) buffer, size * nmemb);\n29    return nmemb;\n30}\n31\n32int get_token(\n33        std::string ak,\n34        std::string sk,\n35        std::string *token) {\n36    CURL *curl = curl_easy_init();\n37    struct curl_slist *slist = NULL;\n38    std::map<std::string, std::string> params;\n39    std::string response;\n40    std::string error;\n41    params[\"grant_type\"] = \"client_credentials\";\n42    params[\"client_id\"] = ak;\n43    params[\"client_secret\"] = sk;\n44    std::string url = \"https://aip.baidubce.com/oauth/2.0/token?\"\n45                      \"grant_type=client_credentials&client_id=\" + ak + \"&client_secret=\" + sk;\n46    curl_easy_setopt(curl, CURLOPT_URL, url.c_str());\n47    curl_easy_setopt(curl, CURLOPT_HTTPHEADER, slist);\n48    curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, onWriteData);\n49    curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);\n50    curl_easy_setopt(curl, CURLOPT_NOSIGNAL, true);\n51    curl_easy_setopt(curl, CURLOPT_CONNECTTIMEOUT_MS, 2000);\n52    curl_easy_setopt(curl, CURLOPT_TIMEOUT_MS, 2000);\n53    curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, false);\n54    curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, false);\n55    curl_easy_setopt(curl, CURLOPT_VERBOSE, false);\n56    int status_code = curl_easy_perform(curl);\n57    curl_easy_cleanup(curl);\n58    curl_slist_free_all(slist);\n59    Json::CharReaderBuilder crbuilder;\n60    std::unique_ptr<Json::CharReader> reader(crbuilder.newCharReader());\n61    Json::Value obj;\n62    reader->parse(response.data(), response.data() + response.size(), &obj, &error);\n63    *token = obj[\"access_token\"].asString();\n64\n65    return status_code;\n66}\n67\n68\n69std::string JsonToString(const Json::Value &root) {\n70    static Json::Value def = []() {\n71        Json::Value def;\n72        Json::StreamWriterBuilder::setDefaults(&def);\n73        def[\"emitUTF8\"] = true;\n74        return def;\n75    }();\n76\n77    std::ostringstream stream;\n78    Json::StreamWriterBuilder stream_builder;\n79    stream_builder.settings_ = def;//Config emitUTF8\n80    std::unique_ptr<Json::StreamWriter> writer(stream_builder.newStreamWriter());\n81    writer->write(root, &stream);\n82    return stream.str();\n83}\n84\n85\n86int hex_char_value(char c) {\n87    if (c >= '0' && c <= '9')\n88        return c - '0';\n89    else if (c >= 'a' && c <= 'f')\n90        return (c - 'a' + 10);\n91    else if (c >= 'A' && c <= 'F')\n92        return (c - 'A' + 10);\n93    assert(0);\n94    return 0;\n95}\n96\n97std::string get_key(std::string res) {\n98    std::string lvStr;\n99    for (int i = 0; i < 16; i++) {\n100        int x = hex_char_value(res[i]);\n101        char c = x;\n102        std::cout << c;\n103        lvStr.append(1, c);\n104    }\n105    return lvStr;\n106}\n107\n108std::string ecb_encrypt(std::string res, std::string source) {\n109    int outlen = 0;\n110    int i = source.size() / 16;\n111    int tail = source.size() % 16;\n112    if (tail > 0) {\n113        i++;\n114    }\n115    unsigned char encData[16 * i];\n116    EVP_CIPHER_CTX *ctx;\n117    ctx = EVP_CIPHER_CTX_new();\n118    EVP_CipherInit_ex(ctx, EVP_aes_128_ecb(), NULL,\n119                      reinterpret_cast<const unsigned char *>(get_key(res).c_str()), NULL, 1);\n120    EVP_CipherUpdate(ctx, encData, &outlen, reinterpret_cast<const unsigned char *>(source.c_str()), source.size());\n121    EVP_CipherFinal(ctx, encData + outlen, &outlen);\n122    EVP_CIPHER_CTX_free(ctx);\n123    std::string data = aip::base64_encode(reinterpret_cast<const char *>(encData), sizeof(encData));\n124    return data;\n125}\n126\n127std::string ecb_decrypt(std::string res, std::string decode) {\n128    std::string data = aip::base64_decode(decode);\n129    int decLen = 0;\n130    int outlen = 0;\n131    unsigned char decData[data.size()];\n132    EVP_CIPHER_CTX *ctx2;\n133    ctx2 = EVP_CIPHER_CTX_new();\n134    EVP_CipherInit_ex(ctx2, EVP_aes_128_ecb(), NULL, reinterpret_cast<const unsigned char *>(get_key(res).c_str()),\n135                      NULL, 0);\n136    EVP_CipherUpdate(ctx2, decData, &outlen, reinterpret_cast<const unsigned char *>(data.c_str()), data.size());\n137    decLen = outlen;\n138    EVP_CipherFinal(ctx2, decData + outlen, &outlen);\n139    decLen += outlen;\n140    EVP_CIPHER_CTX_free(ctx2);\n141    decData[decLen] = '\\0';\n142    printf(\"decrypt: %s\\n\", decData);\n143    std::string result;\n144    result = reinterpret_cast<const char *>(decData);\n145    return result;\n146}\n147\n148template<class CharT, class Traits, class Allocator>\n149std::basic_istream<CharT, Traits> &getall(std::basic_istream<CharT, Traits> &input,\n150                                          std::basic_string<CharT, Traits, Allocator> &str) {\n151    std::ostringstream oss;\n152    oss << input.rdbuf();\n153    str.assign(oss.str());\n154    return input;\n155}\n156\n157inline int get_file_content(const char *filename, std::string *out) {\n158    std::ifstream in(filename, std::ios::in | std::ios::binary);\n159    if (in) {\n160        getall(in, *out);\n161        return 0;\n162    } else {\n163        return -1;\n164    }\n165}\n166\n167/**\n168 * 身份证识别\n169 * @return 调用成功返回0，发生错误返回其他错误码\n170 */\n171Json::Value idcard(const std::string &access_token) {\n172    Json::Value obj;\n173    std::string url = \"https://aip.baidubce.com/rest/2.0/ocr/v1/idcard?access_token=\" + access_token;\n174    CURL *curl = NULL;\n175    CURLcode result_code;\n176    //图片内容\n177    std::string file_content;\n178    get_file_content(\"/Users/lidang/pyproject/baidu/aip/api-python-sdk/test/resources/my.jpg\", &file_content);\n179//    std::string base64 = aip::base64_encode(file_content.c_str(), (int) file_content.size());\n180    std::string res = \"e1ad10e3d69689e0\";\n181    std::string base64 = ecb_encrypt(res, file_content);\n182    int is_success;\n183    std::string response;\n184    std::string error;\n185    curl = curl_easy_init();\n186    if (curl) {\n187        curl_easy_setopt(curl, CURLOPT_URL, url.data());\n188        curl_easy_setopt(curl, CURLOPT_POST, 1);\n189        curl_httppost *post = NULL;\n190        curl_httppost *last = NULL;\n191        curl_formadd(&post, &last, CURLFORM_COPYNAME, \"id_card_side\", CURLFORM_COPYCONTENTS, \"front\", CURLFORM_END);\n192        curl_formadd(&post, &last, CURLFORM_COPYNAME, \"image\", CURLFORM_COPYCONTENTS, base64.c_str(), CURLFORM_END);\n193        curl_formadd(&post, &last, CURLFORM_COPYNAME, \"AESEncry\", CURLFORM_COPYCONTENTS, \"true\", CURLFORM_END);\n194        curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);\n195        curl_easy_setopt(curl, CURLOPT_HTTPPOST, post);\n196        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, onWriteData);\n197        result_code = curl_easy_perform(curl);\n198        if (result_code != CURLE_OK) {\n199            fprintf(stderr, \"curl_easy_perform() failed: %s\\n\",\n200                    curl_easy_strerror(result_code));\n201            is_success = 1;\n202            return is_success;\n203        }\n204        Json::CharReaderBuilder crbuilder;\n205        std::unique_ptr<Json::CharReader> reader(crbuilder.newCharReader());\n206        reader->parse(response.data(), response.data() + response.size(), &obj, &error);\n207        curl_easy_cleanup(curl);\n208        is_success = 0;\n209        return obj;\n210    } else {\n211        fprintf(stderr, \"curl_easy_init() failed.\");\n212        is_success = 1;\n213    }\n214    return obj;\n215}\n216\n217int main() {\n218\n219//    aipt::test_ocr();\n220//    aipt::test_kg();\n221//    aipt::test_speech();\n222//    aipt::test_face();\n223//    aipt::test_nlp();\n224//    aipt::test_ocr();\n225//    aipt::test_image_censor();\n226//    aipt::run_test(1);\n227    std::string ak = \"ak\";\n228    std::string sk = \"sk\";\n229    std::string res = \"控制台的aeskey\";\n230    std::string output;\n231    std::string token;\n232    get_token(ak, sk, &token);\n233    Json::Value result;\n234    result = idcard(token);\n235    std::cout << result[\"result\"];\n236    std::string data = ecb_decrypt(res, result[\"result\"].asString());\n237    std::cout << data + \"\\n\";\n238//    std::string encate = ecb_encrypt(res, \"123456789123456789\");\n239//    std::cout << encate + \"\\n\";\n240//    std::string decode = ecb_decrypt(res,encate);\n241//    std::cout << decode+\"\\n\";\n242    return 0;\n243}
\n
\n \n \n
\n 
1<?php\n2\n3function buildUrl($url, $params)\n4{\n5    if (!empty($params)) {\n6        $str = http_build_query($params);\n7        return $url . (strpos($url, '?') === false ? '?' : '&') . $str;\n8    } else {\n9        return $url;\n10    }\n11}\n12\n13function buildHeaders($headers)\n14{\n15    $result = array();\n16    foreach ($headers as $k => $v) {\n17        $result[] = sprintf('%s:%s', $k, $v);\n18    }\n19    return $result;\n20}\n21\n22function get($url, $params = array(), $headers = array())\n23{\n24    $url = buildUrl($url, $params);\n25\n26    $headers = array_merge($headers, buildHeaders($headers));\n27\n28    $ch = curl_init();\n29    curl_setopt($ch, CURLOPT_URL, $url);\n30    curl_setopt($ch, CURLOPT_HEADER, false);\n31    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\n32    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);\n33    curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\n34    $content = curl_exec($ch);\n35    $code = curl_getinfo($ch, CURLINFO_HTTP_CODE);\n36\n37    if ($code === 0) {\n38        throw new Exception(curl_error($ch));\n39    }\n40\n41    curl_close($ch);\n42    return array(\n43        'code' => $code,\n44        'content' => $content,\n45    );\n46}\n47\n48function post($url, $data = array(), $headers = array())\n49{\n50    $ch = curl_init();\n51    var_dump($url);\n52    curl_setopt($ch, CURLOPT_URL, $url);\n53    curl_setopt($ch, CURLOPT_POST, 1);\n54    curl_setopt($ch, CURLOPT_HEADER, false);\n55    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\n56    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);\n57    curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\n58    curl_setopt($ch, CURLOPT_POSTFIELDS, is_array($data) ? http_build_query($data) : $data);\n59\n60    $content = curl_exec($ch);\n61    $code = curl_getinfo($ch, CURLINFO_HTTP_CODE);\n62\n63    if ($code === 0) {\n64        throw new Exception(curl_error($ch));\n65    }\n66\n67    curl_close($ch);\n68    return array(\n69        'code' => $code,\n70        'content' => $content,\n71    );\n72}\n73\n74function decrypt($sStr, $key)\n75{\n76    $sStr = base64_decode($sStr);\n77    $decrypted = openssl_decrypt($sStr, 'AES-128-ECB', get_key($key), OPENSSL_RAW_DATA);\n78    return $decrypted;\n79}\n80\n81function encrypt($input, $key)\n82{\n83    $data = openssl_encrypt($input, 'AES-128-ECB', get_key($key), OPENSSL_RAW_DATA);\n84    $data = base64_encode($data);\n85    return $data;\n86}\n87\n88function bytesToStr($bytes)\n89{\n90    $str = '';\n91    foreach ($bytes as $ch) {\n92        $str .= chr($ch);\n93    }\n94    return $str;\n95}\n96\n97function get_key($key)\n98{\n99    $arr = str_split($key);\n100    $bytes = array();\n101    for ($i = 0; $i < count($arr); $i++) {\n102        $bytes[] = ord(chr(hexdec($arr[$i])));\n103    }\n104    return bytesToStr($bytes);\n105}\n106\n107$ak = \"ak\";\n108$sk = \"sk\";\n109#aes key 从控制台 文字识别-应用列表-应用管理 获取\n110$aes = 'res';\n111$response = get('https://aip.baidubce.com/oauth/2.0/token', array(\n112    'grant_type' => 'client_credentials',\n113    'client_id' => $ak,\n114    'client_secret' => $sk,\n115));\n116$obj = json_decode($response['content'], true);\n117\n118$token = $obj['access_token'];\n119$url = 'https://aip.baidubce.com/rest/2.0/ocr/v1/idcard?access_token=' . $token;\n120$img = file_get_contents('idcard.jpg');\n121$img_data = encrypt($img, $aes);\n122\n123$data = array();\n124$data['image'] = $img_data;\n125$data['id_card_side'] = 'front';\n126$data['AESEncry'] = 'true';\n127\n128$response = post($url, $data, array());\n129$result =$response['content'];\n130$book = json_decode($result,true);\n131$res=decrypt($book[\"result\"],$aes);\n132echo $res;\n133//构造请求数据json_decode($ content, true);
\n
\n \n \n
\n 
1using System;\n2using NUnit.Framework;\n3using System.Text;\n4using System.Security.Cryptography;\n5using System.IO;\n6using System.Net;\n7using System.Collections.Generic;\n8using Newtonsoft.Json;\n9using Newtonsoft.Json.Linq;\n10using System.Linq;\n11namespace Baidu.Aip\n12{\n13    [TestFixture]\n14    public class Demo\n15    {\n16     \n17\n18        public static byte[] getFileByte(String fileName)\n19        {\n20            FileStream filestream = new FileStream(fileName, FileMode.Open);\n21            byte[] arr = new byte[filestream.Length];\n22            filestream.Read(arr, 0, (int)filestream.Length);\n23            filestream.Close();\n24            return arr;\n25        }\n26         public static string ParseQueryString(Dictionary<string, string> querys)\n27        {\n28            if (querys.Count == 0)\n29                return \"\";\n30            return querys\n31                .Select(pair => pair.Key + \"=\" + pair.Value)\n32                .Aggregate((a, b) => a + \"&\" + b);\n33        }\n34        public static string StreamToString(Stream ss, Encoding enc)\n35        {\n36            string ret;\n37            using (var reader = new StreamReader(ss, enc))\n38            {\n39                ret = reader.ReadToEnd();\n40            }\n41            ss.Close();\n42            return ret;\n43        }\n44        public static JObject OpenApiFetchToken(string ak, string sk, bool throws = false, bool debugLog = false)\n45        {\n46            var querys = new Dictionary<string, string>\n47            {\n48                {\"grant_type\", \"client_credentials\"},\n49                {\"client_id\", ak},\n50                {\"client_secret\", sk}\n51            };\n52            var url = string.Format(\"{0}?{1}\", \"https://aip.baidubce.com/oauth/2.0/token\", ParseQueryString(querys));\n53            if (debugLog)\n54                Console.WriteLine(url);\n55            var webReq = (HttpWebRequest)WebRequest.Create(url);\n56            try\n57            {\n58                var resp = (HttpWebResponse)webReq.GetResponse();\n59                if (resp.StatusCode == HttpStatusCode.OK)\n60                {\n61                    var respStr = StreamToString(resp.GetResponseStream(), Encoding.UTF8);\n62                    var obj = JsonConvert.DeserializeObject(respStr) as JObject;\n63                    if (obj[\"access_token\"] != null && obj[\"expires_in\"] != null)\n64                        return obj;\n65                    if (throws)\n66                        throw new AipException(\"Failed to request token. \" + (string)obj[\"error_description\"]);\n67                    return null;\n68                }\n69                if (throws)\n70                    throw new AipException(\"Failed to request token. \" + resp.StatusCode + resp.StatusDescription);\n71            }\n72            catch (Exception e)\n73            {\n74                if (throws)\n75                    throw new AipException(\"Failed to request token. \" + e.Message);\n76                return null;\n77            }\n78\n79            return null;\n80        }\n81        public static string UrlEncode(string str)\n82        {\n83            StringBuilder sb = new StringBuilder();\n84            byte[] byStr = System.Text.Encoding.UTF8.GetBytes(str); //默认是System.Text.Encoding.Default.GetBytes(str)\n85            for (int i = 0; i < byStr.Length; i++)\n86            {\n87                sb.Append(@\"%\" + Convert.ToString(byStr[i], 16));\n88            }\n89\n90            return (sb.ToString());\n91        }\n92        public static string Encrypt(string toEncrypt, string key)\n93        {\n94            byte[] keyArray = GetKey(key);\n95            byte[] toEncryptArray = UTF8Encoding.UTF8.GetBytes(toEncrypt);\n96            Console.WriteLine(\"Hello World！\" + keyArray.Length);\n97            RijndaelManaged rDel = new RijndaelManaged();\n98            rDel.Key = keyArray;\n99            rDel.Mode = CipherMode.ECB;\n100            rDel.Padding = PaddingMode.PKCS7;\n101\n102            ICryptoTransform cTransform = rDel.CreateEncryptor();\n103            byte[] resultArray = cTransform.TransformFinalBlock(toEncryptArray, 0, toEncryptArray.Length);\n104\n105            return Convert.ToBase64String(resultArray, 0, resultArray.Length);\n106        }\n107        public static string Encrypt(byte[] toEncryptArray, string key)\n108        {\n109            byte[] keyArray = GetKey(key);\n110            Console.WriteLine(\"Hello World！\" + keyArray.Length);\n111            RijndaelManaged rDel = new RijndaelManaged();\n112            rDel.Key = keyArray;\n113            rDel.Mode = CipherMode.ECB;\n114            rDel.Padding = PaddingMode.PKCS7;\n115\n116            ICryptoTransform cTransform = rDel.CreateEncryptor();\n117            byte[] resultArray = cTransform.TransformFinalBlock(toEncryptArray, 0, toEncryptArray.Length);\n118\n119            return Convert.ToBase64String(resultArray, 0, resultArray.Length);\n120        }\n121        public static  byte[] GetKey(string key)\n122        {\n123            byte[] result = new byte[key.Length];\n124            char[] array = key.ToArray();\n125            int i = 0;\n126            for (int a = 0; a < array.Length; a = a + 1)\n127            {\n128                string ch =array[a]+\"\";\n129                int val=Convert.ToInt32(ch,16);\n130                result[a] = (byte)val;\n131            }\n132            return result;\n133        }\n134    \n135\n136\n137        /*\n138         * AES解密\n139         * */\n140        public static string Decrypt(string toDecrypt, string key)\n141        {\n142            byte[] keyArray = GetKey(key);\n143            byte[] toEncryptArray = Convert.FromBase64String(toDecrypt);\n144\n145            RijndaelManaged rDel = new RijndaelManaged();\n146            rDel.Key = keyArray;\n147            rDel.Mode = CipherMode.ECB;\n148            rDel.Padding = PaddingMode.PKCS7;\n149\n150            ICryptoTransform cTransform = rDel.CreateDecryptor();\n151            byte[] resultArray = cTransform.TransformFinalBlock(toEncryptArray, 0, toEncryptArray.Length);\n152\n153            return UTF8Encoding.UTF8.GetString(resultArray);\n154        }\n155\n156        [Test]\n157        public void demo()\n158          {\n159            string res = \"控制台的aeskey\";\n160            string ak = \"ak\";\n161            string sk = \"sk\";\n162\n163            string host = \"https://aip.baidubce.com/rest/2.0/ocr/v1/idcard?access_token=\" + OpenApiFetchToken(ak, sk)[\"access_token\"];\n164            //Console.WriteLine(\"url:\"+host);\n165            Encoding encoding = Encoding.Default;\n166            HttpWebRequest request = (HttpWebRequest)WebRequest.Create(host);\n167            request.Method = \"post\";\n168            request.KeepAlive = true;\n169            //// 图片的base64编码\n170            byte[] file = getFileByte(\"图片路径\");\n171            string base64= Encrypt(file, res);\n172            string str = \"AESEncry=true&id_card_side=\" + \"front\" + \"&image=\" + UrlEncode(base64);\n173            byte[] buffer = encoding.GetBytes(str);\n174            request.ContentLength = buffer.Length;\n175            request.GetRequestStream().Write(buffer, 0, buffer.Length);\n176            HttpWebResponse response = (HttpWebResponse)request.GetResponse();\n177            StreamReader reader = new StreamReader(response.GetResponseStream(), Encoding.Default);\n178            string result = reader.ReadToEnd();\n179            Console.WriteLine(\"身份证识别:\");\n180            Console.WriteLine(result);\n181            Console.WriteLine(\"解密\");\n182            var obj = JsonConvert.DeserializeObject(result) as JObject;\n183            var content=Decrypt((string)obj[\"result\"], res);\n184            Console.WriteLine(content);\n185        }\n186}\n187}
\n
\n \n
\n
\n
\n \n

返回说明

\n

返回示例

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2    \"log_id\":\"2648325511\",\n3    \"result\":\"密文\"\n4}
\n
\n
\n
\n \n

请对result密文进行base64解码后得到byte流，再进行AES解密，得到识别结果的明文。

","fields":{"slug":"Xmhaazmyd","title":"身份证识别","date":"2025-11-04","extractedHeadings":[]},"headings":[{"value":"接口描述","depth":2},{"value":"在线调试","depth":2},{"value":"请求说明","depth":2},{"value":"返回说明","depth":2},{"value":"AES加密","depth":2},{"value":"请求说明","depth":3},{"value":"返回说明","depth":3}]}},"pageContext":{"isCreatedByStatefulCreatePages":false,"slug":"Xmhaazmyd","prev":{"id":"Cmhaaus52","name":"手写文字识别","path":"Cmhaaus52","filePath":"工具及MCP/视觉智能/手写文字识别/通用场景文字识别.md","seo":{"title":"","keywords":"","description":"","serviceType":null},"parentIds":["Qmh8sjs6r","dmha6gfp2","tmha7h8zb"],"parents":[{"id":"Qmh8sjs6r","documentId":"55e80d00-1738-41da-8d8e-153fadfa96d2","name":"工具及MCP","repoName":"aigallery","filePath":"工具及MCP","disabled":false,"path":"Qmh8sjs6r","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":{"title":null,"keywords":null,"description":null,"serviceType":null},"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""},{"id":"dmha6gfp2","documentId":"2f8cfce9-1464-4ac9-ae32-4e0fa55b8330","name":"视觉智能","repoName":"aigallery","filePath":"工具及MCP/视觉智能","disabled":false,"path":"dmha6gfp2","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""},{"id":"tmha7h8zb","documentId":"37bb13f9-2e30-4ff8-af1a-4df4c2665ead","name":"手写文字识别","repoName":"aigallery","filePath":"工具及MCP/视觉智能/手写文字识别","disabled":false,"path":"tmha7h8zb","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":{"title":null,"keywords":null,"description":null,"serviceType":null},"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""}]},"next":{"id":"Dmhaayz0f","name":"卡证文字识别计费说明","path":"Dmhaayz0f","filePath":"工具及MCP/视觉智能/身份证识别/卡证文字识别.md","seo":{"title":"","keywords":"","description":"","serviceType":null},"parentIds":["Qmh8sjs6r","dmha6gfp2","qmha7i7ah"],"parents":[{"id":"Qmh8sjs6r","documentId":"55e80d00-1738-41da-8d8e-153fadfa96d2","name":"工具及MCP","repoName":"aigallery","filePath":"工具及MCP","disabled":false,"path":"Qmh8sjs6r","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":{"title":null,"keywords":null,"description":null,"serviceType":null},"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""},{"id":"dmha6gfp2","documentId":"2f8cfce9-1464-4ac9-ae32-4e0fa55b8330","name":"视觉智能","repoName":"aigallery","filePath":"工具及MCP/视觉智能","disabled":false,"path":"dmha6gfp2","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""},{"id":"qmha7i7ah","documentId":"270361e3-dd7d-4fb3-97b5-b930d7e3a33f","name":"身份证识别","repoName":"aigallery","filePath":"工具及MCP/视觉智能/身份证识别","disabled":false,"path":"qmha7i7ah","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""}]},"parents":[{"id":"Qmh8sjs6r","documentId":"55e80d00-1738-41da-8d8e-153fadfa96d2","name":"工具及MCP","repoName":"aigallery","filePath":"工具及MCP","disabled":false,"path":"Qmh8sjs6r","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":{"title":null,"keywords":null,"description":null,"serviceType":null},"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""},{"id":"dmha6gfp2","documentId":"2f8cfce9-1464-4ac9-ae32-4e0fa55b8330","name":"视觉智能","repoName":"aigallery","filePath":"工具及MCP/视觉智能","disabled":false,"path":"dmha6gfp2","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""},{"id":"qmha7i7ah","documentId":"270361e3-dd7d-4fb3-97b5-b930d7e3a33f","name":"身份证识别","repoName":"aigallery","filePath":"工具及MCP/视觉智能/身份证识别","disabled":false,"path":"qmha7i7ah","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""}],"specificSeo":{"title":"","keywords":"","description":"","serviceType":null}}}}