參考示例 — 身份證識別

AppKey&AppCode管理：在此處可以查看您的AppKey、AppSecret、AppCode

購買服務

1、開通API網關https://www.aliyun.com/product/apigateway

2、在身份證服務https://market.aliyun.com/products/57124001/cmapi010401.html 頁面購買服務

授權API

1、進入API網關-控制臺，點擊左側調用API—> 應用管理，創建新應用。

2、應用創建后，點擊應用名稱，查看應用ID

3、點擊左側已購買API，在對應的API一行中選擇查看API，點擊授權，輸入步驟2獲取的應用ID，進行授權即可。

API調用

API的具體調用方式見身份證服務產品頁面

具體的示例代碼見產品頁面的請求示例代碼，通過此頁面查看APPCODE， 請閱讀API介紹-身份證了解身份證服務具體的輸入輸出格式。

示例如下：

{
	"image":  "圖片二進制數據的base64編碼/圖片url",
	"configure": {
            "side":"face", #身份證正反面類型:face/back
            "quality_info": false   # 是否輸出身份證質量分信息，默認為否（包括 是否是翻拍、是否是復印件、完整度評分、整體質量分數、篡改分數）
         }  
}

上面列出的是識別身份證正面圖像的輸入格式，主要是傳輸了圖像數據和配置字符串，其中圖像是經過base64編碼后的數據，配置字符串主要傳遞了一個參數，表示當前圖像為身份證正面圖像，進行正面識別。

返回結果示例如下：

正面返回結果：
{
  "address"    : "浙江省杭州市余杭區文一西路969號",   #地址信息
  "config_str" : "{\\\"side\\\":\\\"face\\\"}",    #配置信息，同輸入configure
  "face_rect":{       #人臉位置
    "angle": -90,   #angle表示矩形順時針旋轉的度數
    "center":{      #center表示人臉矩形中心坐標
      "x" : 952,
      "y" : 325.5
    },
    "size":{        #size表示人臉矩形長寬
      "height":181.99,
      "width":164.99
    }
  }, 
  "card_region":[  #身份證區域位置，四個頂點表示
     {"x":165,"y":657},
     {"x":534,"y":658},
     {"x":535,"y":31},
     {"x":165,"y":30}
   ],
  "face_rect_vertices":[  #人臉位置，四個頂點表示
      {  
         "x":1024.6600341796875,
         "y":336.629638671875
      },
      {  
         "x":906.66107177734375,
         "y":336.14801025390625
      },
      {  
         "x":907.1590576171875,
         "y":214.1490478515625
      },
      {  
         "x":1025.157958984375,
         "y":214.63067626953125
      }
    ],
  "name" : "張三",                 #姓名
  "nationality": "漢"，            #民族 
  "num" : "1234567890",            #身份證號
  "sex" : "男",                    #性別
  "birth" : "20000101",            #出生日期
  "is_fake": false,                   #是否是復印件
  "warning": {         # 身份證質量分結果，只有當請求參數 quality_info=true 時，才會返回此字段
       "completeness_score": 100,         # 完整度評分（浮點類型）
       "is_copy": 0,          # 是否是復印件（1:是，0:否）
       "is_reshoot": 0,               # 是否是翻拍（1:是，0:否）
       "quality_score": 89.296059,         # 整體質量分數（浮點類型）
       "tamper_score": 99.99968.            # 篡改分數（數值越大表示篡改可能性越大，推薦閾值：60）
    },
  "success" : true                 #識別結果，true表示成功，false表示失敗
}


反面返回結果:
{
    "config_str" : "{\\\"side\\\":\\\"back\\\"}",  #配置信息，同輸入configure
    "start_date" : "19700101",       #有效期起始時間
    "end_date" : "19800101",         #有效期結束時間
    "issue" : "杭州市公安局",         #簽發機關 
    "is_fake": false,                   #是否是復印件
    "success" : true                 #識別結果，true表示成功，false表示失敗
}