개발가이드

  • 개발가이드

개인통관부호 검증

이름, 개인통관고유부호, 우편번호, 전화번호를 입력하여 개인통관부호 일치 여부를 검증합니다.

정보

Method
URL
POST
https://apick.app/rest/check_pccc
이름, 개인통관고유부호, 우편번호, 전화번호 4가지 정보의 일치 여부를 검증합니다. 응답에는 진위 확인 결과(verified)만 포함됩니다. 외부 서버의 상세 메시지는 노출하지 않습니다.

요청

Header
이름
필수
설명
CL_AUTH_KEY
O
인증키(MD5)
FormData
이름
타입
필수
설명
name
String
O
이름
pccc
String
O
개인통관고유부호 (P + 숫자 12자리, 예: P123456789012)
zip
String
O
우편번호 (5자리, 예: 08362)
phone
String
O
전화번호 (숫자만, 예: 01012341234)

응답

Body
이름
타입
설명
data
Object
검증 결과
verified
Boolean
진위 확인 결과 (true: 일치, false: 불일치)
error
String
처리 실패 시 오류 (고정값: "오류")
success
Integer
과금 여부
0: 실패
1: 성공
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/check_pccc" \
-H "CL_AUTH_KEY: $API_KEY" \
--form 'name="홍길동"' \
--form 'pccc="P123456789012"' \
--form 'zip="12345"' \
--form 'phone="01012341234"'
응답 예시 (정상)

{
    "data": {
        "verified": true,
        "success": 1
    },
    "api": {
        "success": true,
        "cost": 20,
        "ms": 5234,
        "pl_id": 4902
    }
}
응답 예시 (불일치)

{
    "data": {
        "verified": false,
        "success": 1
    },
    "api": {
        "success": true,
        "cost": 20,
        "ms": 4821,
        "pl_id": 4903
    }
}
응답 예시 (처리 실패)

{
    "data": {
        "error": "오류",
        "success": 0
    },
    "api": {
        "success": true,
        "cost": 0,
        "ms": 4821
    }
}
현재 페이지 북마크