模擬串接服務 - 身分資料影像辨識

經銷商『身分資料影像辨識』請求欄位
Id Name Description Type Additional Information
1 agent_uid 經銷商商務代號
string 必填
2 service 服務名稱
string 必填
{ "service_name": "ocr", "cmd": "api\/textdetection" }
JSON格式,AES256加密資料
3 encry_data 『身分資料影像辨識』欄位資料 string 必填
『身分資料影像辨識』欄位參考
JSON格式,AES256加密資料
特約商店『身分資料影像辨識』請求欄位
Id Name Description Type Additional Information
1 store_uid 特約商店商務代號
string 必填
2 service 服務名稱
string 必填
{ "service_name": "ocr", "cmd": "api\/textdetection" }
JSON格式,AES256加密資料
3 encry_data 『身分資料影像辨識』欄位資料 string 必填
『身分資料影像辨識』欄位參考
JSON格式,AES256加密資料
身分資料影像辨識』欄位
Id Name Description Type Additional Information
1 store_uid 特約商店商務代號 string 必填
2 images 圖檔陣列內容 array 必填
每筆『身分資料影像辨識圖檔陣列內容』欄位參考
身分資料影像辨識』回傳欄位
Id Name Description Type Additional Information
1 code 執行狀態碼 string 『身分資料解析狀態碼』值參考
2 msg 執行狀態訊息 string
3 content 身分資料影像辨識回傳 object 『身分資料影像辨識回傳參數細項資訊』欄位參考
身分資料影像辨識圖檔陣列內容』欄位
Id Name Description Type Additional Information
1 image_name 圖檔名稱(本次唯一值+副檔名) string 必填
2 url_path url圖檔路徑 string
3 image_content 圖檔本體 string
4 type 辨識內容:identityFront(身分證正面),identityBack(身分證反面),catDriving(駕照), scooterLicense(機車行照), carLicenseFront(汽車行照正面),carLicenseBack(汽車行照反面), healthIdCard(健保卡)carLicense(汽車行照) string 必填
身分資料解析狀態碼』 值內容
Value Description Type Additional Information
100 資料不正確 string
400 系統錯誤 string
B200 執行成功 string
B500 執行失敗 string
身分資料影像辨識回傳參數細項資訊』欄位
Id Name Description Type Additional Information
1 code 身分資料影像辨識狀態碼 string 『身分資料解析狀態碼』值參考
2 msg 身分資料影像辨識狀態碼說明 string
3 image_name 身分資料影像辨識圖檔名稱 string
4 type 身分資料影像辨識執行方式
辨識內容:identityFront(身分證正面),identityBack(身分證反面),catDriving(駕照), scooterLicense(機車行照), carLicenseFront(汽車行照正面),carLicenseBack(汽車行照反面), healthIdCard(健保卡)carLicense(汽車行照)
string
5 result 回傳辨識結果 array 每筆『機車行照回傳資料』欄位參考
每筆『身份證正面回傳資料』欄位參考
每筆『身份證背面回傳資料』欄位參考
每筆『健保卡回傳資料』欄位參考
每筆『駕照回傳資料』欄位參考
每筆『汽車行照正面回傳資料』欄位參考
每筆『汽車行照背面回傳資料』欄位參考
每筆『汽車行照回傳資料』欄位參考
機車行照回傳資料』欄位
Id Name Description Type Additional Information
1 license 牌照 string
2 car_owner 車主 string
3 address 住址 string
4 brand_type 廠牌型式 string
5 engine_number 引擎號碼 string
6 body_number 車身號碼 string
7 color 顏色 string
8 displacement 排氣量 string
9 issue_date 發照日期MYYMMDD string
10 factory_year_month 出廠年月YYYYMMDD string
11 replacement_date 換補照日期MYYMMDD string
12 expired_date 有效日期MYYMMDD|string string
13 jurisdiction_number 管轄編號 string
身份證正面回傳資料』欄位
Id Name Description Type Additional Information
1 name 姓名 string
2 birthday 出生年月日MYYMMDD string
3 gender 性別 string
4 issue_date 發照日期MYYMMDD string
5 issue_site_id 發證地點 string
6 id 身份證號 string
7 category_code 領補換類別代碼 string
身份證背面回傳資料』欄位
Id Name Description Type Additional Information
1 father 父親 string
2 mother 母親 string
3 spouse 配偶 string
4 service_type 役別 string
5 address 地址 string
健保卡回傳資料』欄位
Id Name Description Type Additional Information
1 name 姓名 string
2 id 身分證號 string
3 birthday 出生年月日MYYMMDD string
4 card_number 卡號 string
駕照回傳資料』欄位
Id Name Description Type Additional Information
1 name 姓名 string
2 gender 姓別 string
3 birthday 出生年月日MYYMMDD string
4 types_of_drivers_license 駕照類型 string
5 drivers_license_number 駕照號碼 string
6 license_conditions 持照條件 string
7 address 住址 string
8 jurisdiction_number 管轄編號 string
9 issue_date 發照日期MYYMMDD string
汽車行照正面回傳資料』欄位
Id Name Description Type Additional Information
1 license 牌照 string
2 name 姓名 string
3 address 地址 string
4 factory 廠牌 string
5 year_of_manufacture 出廠年月 string
6 pattern 型式 string
7 exhaust_volume 排氣量 string
8 fuel_type 燃料種類 string
9 engine_number 引擎號碼 string
汽車行照背面回傳資料』欄位
Id Name Description Type Additional Information
1 tag_title 牌照標頭 string
2 original_issue_date 原發照日期MYYMMDD string
3 replacement_date 更換日期MYYMMDD string
4 expired_date 有效日期MYYMMDD|string string
5 color 顏色 string
汽車行照回傳資料』欄位
Id Name Description Type Additional Information
1 license 牌照 string
2 name 姓名 string
3 address 地址 string
4 factory 廠牌 string
5 year_of_manufacture 出廠年月 string
6 pattern 型式 string
7 exhaust_volume 排氣量 string
8 fuel_type 燃料種類 string
9 engine_number 引擎號碼 string
10 tag_title 牌照標頭 string
11 original_issue_date 原發照日期MYYMMDD string
12 replacement_date 更換日期MYYMMDD string
13 expired_date 有效日期MYYMMDD|string string
14 color 顏色 string
AES256資料加密方式說明

1、所有的API送出HTTPs請求之欄位中,service 和 encry_data 欄位皆進行 AES256+BASE64 加密處理。
2、AES加密,格式為CBC,長度為256bits,金鑰長度32,IV長度16,傳遞內文為加密後組合IV並經過Base64轉換後傳出。

方式:
使用自訂的AES256函式將JSON資料加密後,再將IV資料和此AES256加密後的JSON資料串聯後,使用base64再進行加密成ASCII字串即可完成加密。

    PHP加密示意:
    AesEncrypt -> base64_ecode($IV . $JSON)

    C#加密示意:
    AesEncrypt -> (bytes)IV+(bytes)Json -> toBase64

    Java加密示意:
    AesEncrypt -> (bytes)IV+(bytes)Json -> toBase64

    Node.js加密示意:
    AesEncrypt -> concat([IV,JSON], [IV_SIZE,JSON_SIZE]) -> toString('base64')
    Python加密示意:
    AesEncrypt -> (bytes)IV+(bytes)Json -> base64.b64encode

範例程式碼