## 身份證識別接口 >[success]亮點：支持身份證圖片地址識別！底層托管阿里云Serverless平臺，性能穩定。支持對二代居民身份證正反面的關鍵字段識別，包括姓名、性別、民族、出生日期、住址、身份證號、簽發機關、有效期限，識別準確率可達98%以上 *調用地址：*http(s)://shenfenzhe.market.alicloudapi.com/do *請求方式：*POST *返回類型：*JSON | 名稱 | 類型 | 是否必須 | 描述 | | --- | --- | --- | --- | | id\_card\_side | STRING | 必選 | front 正面 back反面 若正反面在一張圖片上，需分別用正反參數解析兩次 | | image | STRING | 必選 | 身份證圖片外網地址或base64編碼，不含data:image/jpeg;base64,前綴，base64編碼后進行urlencode，要求base64編碼和urlencode后大小不超過4M，最短邊至少15px，最長邊最大4096px,支持jpg/png/bmp格式 | | detect\_direction | STRING | 可選 | 是否檢測圖像旋轉角度，默認不檢測，即：false。朝向是指輸入圖像是正常方向、逆時針旋轉90/180/270度。可選值包括: - true：檢測旋轉角度并矯正識別； - false：不檢測旋轉角度，針對擺放情況不可控制的情況建議本參數置為true。 | | detect\_risk | STRING | 可選 | 是否開啟身份證風險類型(身份證復印件、臨時身份證、身份證翻拍、修改過的身份證)功能，默認不開啟，即：false。可選值:true-開啟；false-不開啟 | | detect\_photo | STRING | 可選 | 是否檢測頭像內容，默認不檢測。可選值：true-檢測頭像并返回頭像的 base64 編碼及位置信息 | | detect\_rectify | STRING | 可選 | 是否進行完整性校驗，默認為true，需上傳各字段內容完善的圖片方可識別；如果設置為false，則對于身份證切片（如僅身份證號區域）也可識別 | ## 返回說明 **返回參數** | 字段 | 一定返回 | 類型 | 說明 | | --- | --- | --- | --- | |msg|是|array|識別結果集| |--以下為正面返回 | | |--name||string|姓名| |--birthday||string|出生日期，格式為Ymd| |--sex||string|性別，男或女| |--idcardno||string|身份證號碼| |--address||string|地址| |--nation||string|民族| |--以下為背面返回 | | |--gov||string|簽發機關| |--begindate||string|簽發日期，格式為Ymd| |--enddate||string|失效日期，格式為Ymd| | direction | 否 | int32 | 圖像方向，當 detect\_direction = true 時，返回該參數。 \- -1:未定義， \- 0:正向， \- 1: 逆時針90度， \- 2:逆時針180度， \- 3:逆時針270度 | | image\_status | 是 | string | normal-識別正常 reversed\_side-身份證正反面顛倒 non\_idcard-上傳的圖片中不包含身份證 blurred-身份證模糊 other\_type\_card-其他類型證照 over\_exposure-身份證關鍵字段反光或過曝 over\_dark-身份證欠曝（亮度過低） unknown-未知狀態 | | risk\_type | 否 | string | 輸入參數 detect\_risk = true 時，則返回該字段識別身份證類型: normal-正常身份證；copy-復印件；temporary-臨時身份證；screen-翻拍；unknown-其他未知情況 | | edit\_tool | 否 | string | 如果參數 detect\_risk = true 時，則返回此字段。如果檢測身份證被編輯過，該字段指定編輯軟件名稱，如:Adobe Photoshop CC 2014 (Macintosh),如果沒有被編輯過則返回值無此參數 | | log\_id | 是 | uint64 | 唯一的log id，用于問題定位 | | photo | 否 | string | 當請求參數 detect\_photo = true時返回，頭像切圖的 base64 編碼（無編碼頭，需自行處理） | | photo\_location | 否 | array() | 當請求參數 detect\_photo = true時返回，頭像的位置信息（坐標0點為左上角） | | idcard\_number\_type | 是 | string | 用于校驗身份證號碼、性別、出生是否一致，輸出結果及其對應關系如下： **\-1:**身份證正面所有字段全為空 **0:**身份證證號識別錯誤 **1:**身份證證號和性別、出生信息一致 **2:**身份證證號和性別、出生信息都不一致 **3:**身份證證號和出生信息不一致 **4:**身份證證號和性別信息不一致 | | words\_result | 是 | array() | 定位和識別結果數組 | | words\_result\_num | 是 | uint32 | 識別結果數，表示words\_result的元素個數 | | +location | 是 | array() | 位置數組（坐標0點為左上角） | | ++left | 是 | uint32 | 表示定位位置的長方形左上頂點的水平坐標 | | ++top | 是 | uint32 | 表示定位位置的長方形左上頂點的垂直坐標 | | ++width | 是 | uint32 | 表示定位位置的長方形的寬度 | | ++height | 是 | uint32 | 表示定位位置的長方形的高度 | | +words | 否 | string | 識別結果字符串 | >[info] 在線調試：請點擊調試按鈕旁邊的鑰匙寫入您的APPCODE ~~~[api] post:https://shenfenzhe.market.alicloudapi.com/do *string:image=http://storage.api51.cn/demo/zheng.jpg#身份證照片遠程地址，正反面請分別請求 *id_card_side=front#front正面，back反面 <<< success <<< error ~~~