개발가이드

  • 개발가이드

성명/주민등록번호 실명확인

성명과 주민등록번호를 입력받아 실제 존재여부를 확인합니다.

정보

Method
URL
POST
https://apick.app/rest/name_rrn_auth

요청

Header
이름
필수
설명
CL_AUTH_KEY
O
인증키(MD5)
Content-Type
O
요청 데이터 타입
Content-Type: application/json
FormData
이름
타입
필수
설명
name
String
O
한글성명
rrn1
String
O
주민등록번호 앞 6자리 숫자
rrn2
String
O
주민등록번호 뒤 7자리 숫자

응답

Body
이름
타입
설명
data
Object
조회 데이터
result
Integer
실명확인 결과
1 : 실명인증 성공
0 : 실명인증 실패
-1 : 실명인증 오류
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/name_rrn_auth" \
-H "CL_AUTH_KEY: $API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "name" : "에이픽",
    "rrn1" : "851011",
    "rrn2" : "1028511"
}'
            
응답 예시

{
    "data": {
        "result": 1,
        "msg": "실명과 주민등록번호가 일치합니다.",
        "success": 1
    },
    "api": {
        "success": true,
        "cost": 40,
        "ms": 741,
        "pl_id": 1252133
    }
}
            
현재 페이지 북마크