개발가이드

  • 개발가이드


[Text] 운전면허증 진위 확인

운전면허증의 진위여부를 확인합니다.

정보

Method
URL
POST
https://apick.app/rest/identi_card/2

요청

Header
이름
필수
설명
CL_AUTH_KEY
O
인증키(MD5)
FormData
이름
타입
필수
설명
birth_y
String
O
년(생년월일)1
birth_m
String
O
월(생년월일)2
birth_d
String
O
일(생년월일)3
name
String
O
이름4
licen_no0
String
O
면허번호15
licen_no1
String
O
면허번호26
licen_no2
String
O
면허번호37
licen_no3
String
O
면허번호48
ghost_num
String
X
식별번호9
식별번호는 운전면허증 앞면 우측 작은 사진 밑에 표기된 암호일련번호입니다. 식별번호(ghost_num)는 선택 항목입니다. 생략하거나 빈 문자열로 보내도 조회할 수 있으며, 전달한 값의 내용은 판정에 사용하지 않습니다. 별도의 고정값을 입력하거나 고객에게 식별번호를 수집할 필요가 없습니다. 이 API는 면허번호와 인적사항의 일치 여부를 조회하며, 암호일련번호 자체의 일치 여부나 실물 면허증의 위·변조 여부를 보증하지 않습니다.

응답

Body
이름
타입
설명
data
Object
조회 데이터
ic_id
Integer
신분증 진위 확인 요청 ID
type
Integer
신분증 종류
1: 주민등록증
2: 운전면허증
3: 여권
4: 주민등록등본
5: 외국인등록증
result
Integer
조회 결과
0: 불일치
1: 일치
2: 판정 확인 실패(HTTP 424, 무과금)
3: 처리 시간 초과(HTTP 408, 무과금)
msg
String
메시지
success
Integer
과금 여부
0: 실패
1: 성공
3: 실패(timeout)
api
Object
API 호출 공통 데이터
success
Boolean
API 서버 정상 응답 여부
cost
Integer
API 호출 요금
ms
Integer
API 응답 시간
pl_id
Integer
API 결제 로그 ID

예시

요청 예시

curl -k -X POST "https://apick.app/rest/identi_card/2" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "birth_y=2000" \
-F "birth_m=01" \
-F "birth_d=01" \
-F "name=홍길동" \
-F "licen_no0=21" \
-F "licen_no1=19" \
-F "licen_no2=174133" \
-F "licen_no3=01" \
-F "ghost_num=8H1X3Y"
응답 예시

{
    "data": {
        "ic_id": 102325,
        "type": 2,
        "result": 1,
        "msg": "",
        "success": 1
    },
    "api": {
        "success": true,
        "cost": 40,
        "ms": 3038,
        "pl_id": 106496
    }
}
현재 페이지 북마크