개발가이드

  • 개발가이드

[Text] 외국인등록증 진위 확인

외국인등록증의 진위여부를 확인합니다.

정보

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

요청

Header
이름
필수
설명
CL_AUTH_KEY
O
인증키(MD5)
FormData
이름
타입
필수
설명
rrn
String
O
외국인등록번호1
made_date
String
O
발급일자2
card_sn
String
X
일련번호3
일련번호는 카드 뒷면에 표기되어 있습니다.
2011.01.01 이전에 발급된 등록증은 공란으로 요청하면 됩니다.

응답

Body
이름
타입
설명
data
Object
조회 데이터
ic_id
Integer
신분증 진위 확인 요청 ID
type
Integer
신분증 종류
result
Integer
조회 결과
0: 실패, 1: 성공
2: msg 확인, 3: 실패(timeout)
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/5" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "rrn=1234561234567" \
-F "made_date=2020-01-01" \
-F "card_sn=10181111111"
응답 예시

{
    "data": {
        "ic_id": 121305,
        "type": 5,
        "result": 1,
        "msg": "귀하께서 조회하신 외국인등록번호 1234561234567,   발급일자 2020-01-01,   일련번호 10181111111\n 법무부가 보유한 정보와 일치합니다.\n\n\n※ 조회결과는 전산기록과 비교한 것이므로 위조제작이나 사진교체 등 위ㆍ변조 여부에 대한 판단 기준은 될 수 없습니다.",
        "success": 1
    },
    "api": {
        "success": true,
        "cost": 40,
        "ms": 2020,
        "pl_id": 128605
    }
}
현재 페이지 북마크