Grind away: 개인통관고유부호 인증 요청 API · 정보 조회 자동화 · 호출당 과금 REST API

2026년 4월 22일 수요일

개인통관고유부호 인증 요청 API · 정보 조회 자동화 · 호출당 과금 REST API | APICK 에이픽

APICK · SERVICE BROCHURE · 정보 조회

개인통관고유부호 인증 요청 API

관세청 개인통관고유부호(PCCC) 발급·조회를 위한 본인 인증을 요청하는 API

💳 호출당 미명시 ⚡ 실시간 응답 🔐 단일 인증키 📡 REST 표준

About APICK

APICK 은 어떤 서비스인가요?

APICK(에이픽) 은 금융·사업자·부동산·신분증·OCR·이미지·문서까지 80여 종의 비즈니스 API 를 REST 표준으로 제공하는 호출당 과금 플랫폼 입니다. 단일 인증키 CL_AUTH_KEY 하나로 모든 API 를 사용할 수 있고, 월 최소 비용 없이 호출한 만큼만 과금되는 투명한 요금 정책이 특징입니다.

✅ 단일 인증키 · 80+ REST API 통합 사용 — 한 번 가입하면 추가 계약 없이 바로 확장
✅ 호출당 포인트 과금 · 월 최소 비용 없음 — 트래픽 규모와 무관하게 부담 없이 시작
✅ 실시간 응답 · 호출 메타 자동 제공 — api.cost · api.ms · api.pl_id 자동 기록

APICK 회원가입 · 지금 시작하기 →

왜 APICK 인가 · 3가지 핵심 강점

정찰제 · 투명 가격

모든 API 가격이 정찰제로 공개되어 누구나 동일한 조건으로 이용합니다.

가입 즉시 전체 사용

회원가입 후 포인트 충전만으로 80여 종 API 를 즉시 호출할 수 있습니다.

5분 연동 · 무심사

별도 인증·심사·계약 없이 가입 후 5분 안에 모든 API 를 연동합니다.

주요 서비스 분야

금융·계좌 인증

계좌 실명 조회 · 은행코드 · 1원 인증 · 거래영업일

사업자·기업

사업자 정보 · 벤처기업 · 휴폐업 · 세무 상태

부동산·등기

건축물대장 · 인터넷등기소 · 토지대장 · 공시지가

개인·신분증 인증

주민번호 진위 · 신분증 OCR·진위 · 개인통관부호

이미지·영상·음성

얼굴 감지·블러 · 워터마크 · STT · TTS · 음성 변환

웹·문서·주소·검색

구글·유튜브 · URL 스크린샷 · PDF·DOCX 변환 · 도로명

한눈에 보는 연동 사양

엔드포인트

/rest/req_pccc

REST · POST 요청

호출 단가

정책 별도

후불제 정책 별도 · 호출당

응답 시간

api.ms

응답 본문 api.ms 값으로 확인

핵심 특장점 · 빠른 도입 포인트

연동 담당자가 가장 먼저 확인하면 좋은 6가지 포인트입니다.

최소 입력 · 즉시 응답

필수 파라미터만 전달하면 평균 10초 이내, 최대 35초 응답으로 실시간 검증이 가능합니다.

표준 인증 방식

CL_AUTH_KEY (MD5 인증키) 를 헤더로 전달. 별도 OAuth 흐름 없이 즉시 호출 가능합니다.

호출 메타 자동 제공

응답에 api.cost · api.ms · api.pl_id 가 함께 반환되어 과금·성능·결제 로그를 즉시 추적할 수 있습니다.

투명한 과금

선불제 호출당 과금 · 후불제 정책 별도. 응답 본문 api.cost 로 실제 차감 포인트를 확인합니다.

단순 REST 인터페이스

표준 POST 요청 + FormData 형식으로 어떤 언어·프레임워크에서도 즉시 통합 가능합니다.

실패 응답 처리

data.success 값으로 판단: 0 실패 · 1 성공 · 3 타임아웃. 실패 응답은 정책에 따라 과금되지 않을 수 있습니다.

도입 효과

호출 메타 자동 제공 · 표준 REST 인터페이스 · 실시간 응답으로 기존 서비스 흐름에 즉시 편입됩니다.

✅ 호출 메타 자동 제공

api.cost / api.ms / api.pl_id 로 호출당 과금·성능·결제 로그를 즉시 추적합니다.

✅ 표준 REST 인터페이스

단순 POST + FormData 구조로 어떤 언어·프레임워크에서도 즉시 통합됩니다.

✅ 실시간 응답

평균 10초 이내 응답으로 사용자 흐름 중간에 자연스럽게 호출할 수 있습니다.

연동 사양 요약

Method	POST
Endpoint	`https://apick.app/rest/req_pccc`
Header	CL_AUTH_KEY(인증키(MD5))
FormData	값: name, rrn1, rrn2, phone
Response	data · api 객체
api 객체	success · cost · ms · pl_id
success 값	0 실패 · 1 성공 · 3 타임아웃
응답시간	api.ms 값으로 확인 · 네트워크 상황에 따라 변동
과금 단위	미명시 / 호출당

요청 파라미터

이름	타입	필수	설명
`name`	String	필수	이름
`rrn1`	String	필수	주민등록번호 앞 6자리
`rrn2`	String	필수	주민등록번호 뒤 7자리
`phone`	String	필수	휴대전화 번호(본인명의)

요청 예시 · cURL

공식 가이드 기준 파라미터를 FormData 로 전달, 인증키는 헤더로 전달합니다.

curl -k -X POST "https://apick.app/rest/req_pccc" \
  -H "CL_AUTH_KEY: $API_KEY" \
  -F "name=sample" \
  -F "rrn1=sample" \
  -F "rrn2=sample" \
  -F "phone=sample"

응답 예시 · JSON 샘플

표준 응답 구조 샘플입니다. 실제 필드·값은 호출 대상에 따라 달라질 수 있으며, 정확한 스펙은 공식 개발가이드를 기준으로 확인하세요.

{
  "data": {
    "auth_key": "a0a0000105a80770772114c3d1081158ad1af00e53f2b6dd8b49ae7619b552a68142d88fd59d3a7fbef553c1dcdcc5d08cabf184ad241fe7ddfde66a7a4847769fac3cee38f85aa8c274b133128e8ec097faf63fee89f2212248524d7a6e9d3044bb988f1ff7aad7e9383bb35867a7d51260d11dccf491b21bed68ba58aaaf4c869df4801004a0d866c0471ef43ae99d9dd7436cdb06771143463bdae03a5faae702a80b72abba1f25d31b17dadc0e9eedccefd293e44cb93139de0cc619bf3cf861ddeb827ddf0863cdaafe7f24228d2b4f949be38c9aeaddd0758256d001340e0f267c8e54d9224583831cec8dad4544d4",
    "success": 1
  },
  "api": {
    "success": true,
    "cost": 30,
    "ms": 2123,
    "pl_id": 4901
  }
}

응답 필드

경로	타입	설명
`data`	Object	조회 데이터
`data.auth_key`	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

도입 체크리스트

Checklist

연동 작업 전 확인이 필요한 항목

✓APICK 회원가입 후 인증키(CL_AUTH_KEY) 발급

✓선불제 포인트 충전 또는 후불제 약정

✓호출 IP 화이트리스트 설정 검토

✓응답 객체 파싱 및 빈 값 처리 정책 수립

✓타임아웃(35초) 대응 로직 구현

✓api.cost 기반 과금 모니터링 구성

📄 개인통관고유부호 인증 요청 API 가이드 PDF 다운로드

지금 바로 APICK 에 연동해보세요

회원가입 즉시 CL_AUTH_KEY 발급.
개인통관고유부호 인증 요청 API 는 호출당 정책 별도, 월 최소 비용 없이 호출한 만큼만 과금됩니다.

APICK 회원가입 · 지금 시작하기 → 공식 개발 가이드 보기

* 본 문서는 APICK 공식 스펙을 바탕으로 정리한 연동 참고 자료입니다. 최신·정확한 스펙은 공식 개발 가이드 를 기준으로 확인하세요.

#APICK #에이픽 #비즈니스API #호출당과금API #RESTAPI #단일인증키API #월최소비용없는API #개발자API #개인통관고유부호인증요청API

Grind away