# [Image/PDF] 운전면허증 진위 확인 운전면허증 파일로 진위여부를 확인합니다. 인증: Authorization: Bearer $APICK_API_KEY 본문 있는 REST 요청: multipart/form-data. GET 본문 및 MCP JSON-RPC 규격은 해당 명세를 따릅니다. 인증키는 서버에 보관하세요. 모든 예제는 정적 자료입니다. ## POST /rest/identi_card_image/2 응답 필드 - `data` (object): 조회 데이터 - `data.ic_id` (integer): 신분증 진위 확인 요청 ID - `data.type` (integer): 신분증 종류1: 주민등록증2: 운전면허증3: 여권4: 주민등록등본5: 외국인등록증 - `data.result` (integer): 조회 결과0: 실패1: 성공2: 추가 확인 필요(msg 참고)3: 실패(timeout) - `data.msg` (string): 메시지 - `data.parsed` (object): 파싱 결과 - `data.parsed.name` (string): 이름 - `data.parsed.birth_y` (string): 년(생년월일) - `data.parsed.birth_m` (string): 월(생년월일) - `data.parsed.birth_d` (string): 일(생년월일) - `data.parsed.rrn1` (string): 주민번호 앞자리 - `data.parsed.rrn2` (string): 주민번호 뒷자리 - `data.parsed.licen_no0` (string): 면허번호1 - `data.parsed.licen_no1` (string): 면허번호2 - `data.parsed.licen_no2` (string): 면허번호3 - `data.parsed.licen_no3` (string): 면허번호4 - `data.parsed.ghost_num` (string): 식별번호 - `data.success` (integer): 과금 여부0: 실패1: 성공3: 실패(timeout) - `api` (object): API 호출 공통 데이터 - `api.success` (boolean): API 서버 정상 응답 여부 - `api.cost` (integer): API 호출 요금 - `api.ms` (integer): API 응답 시간 - `api.pl_id` (integer): API 결제 로그 ID ## API 요청: POST /rest/identi_card_image/2 ### 입력 - `image` (file, 필수): 운전면허증 사진 ### 응답 명세 ```json { "type": "object", "properties": { "data": { "type": "object", "properties": { "ic_id": { "type": "integer", "description": "신분증 진위 확인 요청 ID" }, "type": { "type": "integer", "description": "신분증 종류1: 주민등록증2: 운전면허증3: 여권4: 주민등록등본5: 외국인등록증" }, "result": { "type": "integer", "description": "조회 결과0: 실패1: 성공2: 추가 확인 필요(msg 참고)3: 실패(timeout)" }, "msg": { "type": "string", "description": "메시지" }, "parsed": { "type": "object", "properties": { "name": { "type": "string", "description": "이름" }, "birth_y": { "type": "string", "description": "년(생년월일)" }, "birth_m": { "type": "string", "description": "월(생년월일)" }, "birth_d": { "type": "string", "description": "일(생년월일)" }, "rrn1": { "type": "string", "description": "주민번호 앞자리" }, "rrn2": { "type": "string", "description": "주민번호 뒷자리" }, "licen_no0": { "type": "string", "description": "면허번호1" }, "licen_no1": { "type": "string", "description": "면허번호2" }, "licen_no2": { "type": "string", "description": "면허번호3" }, "licen_no3": { "type": "string", "description": "면허번호4" }, "ghost_num": { "type": "string", "description": "식별번호" } }, "description": "파싱 결과" }, "success": { "type": "integer", "description": "과금 여부0: 실패1: 성공3: 실패(timeout)" } }, "description": "조회 데이터" }, "api": { "type": "object", "properties": { "success": { "type": "boolean", "description": "API 서버 정상 응답 여부" }, "cost": { "type": "integer", "description": "API 호출 요금" }, "ms": { "type": "integer", "description": "API 응답 시간" }, "pl_id": { "type": "integer", "description": "API 결제 로그 ID" } }, "description": "API 호출 공통 데이터" } } } ``` ### 정적 응답 예시 ```json { "data": { "ic_id": 124343, "type": 2, "result": 1, "msg": "", "parsed": { "name": "홍길동", "birth_y": "2000", "birth_m": "01", "birth_d": "01", "rrn1": "000101", "rrn2": "1234567", "licen_no0": "21", "licen_no1": "19", "licen_no2": "174133", "licen_no3": "01", "ghost_num": "1A2B3C" }, "success": 1 }, "api": { "success": true, "cost": 60, "ms": 4319, "pl_id": 132194 } } ``` ### curl ```curl curl --fail-with-body --request POST 'https://apick.app/rest/identi_card_image/2' \ --header "Authorization: Bearer $APICK_API_KEY" \ --form 'image=@/C:/Users/user/Desktop/sample_idcard.png' ``` ### Node.js (서버 ESM) ```javascript import { readFile } from "node:fs/promises"; const form = new FormData(); form.append("image", new Blob([await readFile("/C:/Users/user/Desktop/sample_idcard.png")]), "sample_idcard.png"); const response = await fetch("https://apick.app/rest/identi_card_image/2", { method: "POST", headers: { Authorization: "Bearer " + process.env.APICK_API_KEY }, body: form, signal: AbortSignal.timeout(120_000), }); if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`); const result = await response.json(); console.log(result); ``` ### python ```python import os import requests parts = [ ("image", ("sample_idcard.png", open("/C:/Users/user/Desktop/sample_idcard.png", "rb"))), ] response = requests.request("POST", "https://apick.app/rest/identi_card_image/2", headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]}, files=parts, timeout=(10, 120)) response.raise_for_status() result = response.json() print(result) ``` ### php ```php new CURLFile('/C:/Users/user/Desktop/sample_idcard.png'), ]; $curl = curl_init('https://apick.app/rest/identi_card_image/2'); curl_setopt_array($curl, [ CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => $headers, CURLOPT_POSTFIELDS => $form, CURLOPT_RETURNTRANSFER => true, CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120, ]); $body = curl_exec($curl); if ($body === false) { throw new RuntimeException(curl_error($curl)); } $status = curl_getinfo($curl, CURLINFO_HTTP_CODE); curl_close($curl); if ($status >= 400) { throw new RuntimeException($body); } $result = json_decode($body, true, 512, JSON_THROW_ON_ERROR); print_r($result); ``` ## 코드·오류 ## 상세 기능·요금 업로드 용량 제한: 50MB 첨부 이미지 합계는 최대 50MB입니다. 서버가 판독 가능한 크기로 최적화하며, 지나치게 큰 해상도는 정확도를 높이지 않고 처리시간만 늘릴 수 있습니다. 제한을 초과하면 HTTP 413과 REQUEST_TOO_LARGE 오류가 반환되며 과금되지 않습니다. Method URL POST https://apick.app/rest/identi_card_image/2 ## 상세 요청 Header 이름 필수 설명 Authorization O Bearer 인증키 ## 상세 응답 Body 이름 타입 설명 data Object 조회 데이터 ic_id Integer 신분증 진위 확인 요청 ID type Integer 신분증 종류1: 주민등록증2: 운전면허증3: 여권4: 주민등록등본5: 외국인등록증 result Integer 조회 결과0: 실패1: 성공2: 추가 확인 필요(msg 참고)3: 실패(timeout) msg String 메시지 parsed Object 파싱 결과 name String 이름 birth_y String 년(생년월일) birth_m String 월(생년월일) birth_d String 일(생년월일) rrn1 String 주민번호 앞자리 rrn2 String 주민번호 뒷자리 licen_no0 String 면허번호1 licen_no1 String 면허번호2 licen_no2 String 면허번호3 licen_no3 String 면허번호4 ghost_num String 식별번호 success Integer 과금 여부0: 실패1: 성공3: 실패(timeout) api Object API 호출 공통 데이터 success Boolean API 서버 정상 응답 여부 cost Integer API 호출 요금 ms Integer API 응답 시간 pl_id Integer API 결제 로그 ID ## 상세 예제 요청 예시 form-data 전체 예제 보기 응답 예시 { "data": { "ic_id": 124343, "type": 2, "result": 1, "msg": "", "parsed": { "name": "홍길동", "birth_y": "2000", "birth_m": "01", "birth_d": "01", "rrn1": "000101", "rrn2": "1234567", "licen_no0": "21", "licen_no1": "19", "licen_no2": "174133", "licen_no3": "01", "ghost_num": "1A2B3C" }, "success": 1 }, "api": { "success": true, "cost": 60, "ms": 4319, "pl_id": 132194 } }