# 개인통관고유부호 조회 req_pccc 로 받은 tx_id 로 처리 상태를 확인합니다. 사용자가 승인하기 전에는 인증 대기 상태를 돌려주고, 승인되면 개인통관고유부호와 주소를 반환합니다. 인증: Authorization: Bearer $APICK_API_KEY 본문 있는 REST 요청: multipart/form-data. GET 본문 및 MCP JSON-RPC 규격은 해당 명세를 따릅니다. 인증키는 서버에 보관하세요. 모든 예제는 정적 자료입니다. ## POST /rest/get_pccc 응답 필드 - `data` (object): 조회 결과 - `data.tx_id` (string): 트랜잭션 ID - `data.status` (string): 처리 상태pending: 인증 대기 (무과금)collecting: 조회 처리 중 (무과금)verified: 조회 완료 (과금)expired: 24시간 경과, 재인증 필요 - `data.message` (string): 상태 메시지 (pending 이면 "인증 대기중입니다.")발급된 부호가 없으면 "조회된 개인통관고유부호가 없습니다." - `data.success` (integer): 과금 여부0: 실패·승인 대기·부호 없음(무과금)1: 성공(과금)3: 실패(timeout) - `data.checked_at` (string): 정보를 확인한 시각(ISO 8601, status 가 verified 일 때) - `data.개인통관고유부호` (string): 개인통관고유부호 (status 가 verified 이고 부호가 있을 때) - `data.이름` (string): 이름 - `data.주소` (string): [우편번호] 기본주소 상세주소 - `data.전화번호` (string): 전화번호 - `data.사용여부` (string): 사용여부 - `data.error` (string): 처리 실패 시 오류 메시지 - `api` (object): API 호출 공통 데이터 - `api.success` (boolean): API 서버 정상 응답 여부 - `api.cost` (integer): API 호출 요금 - `api.ms` (integer): API 응답 시간 - `api.pl_id` (integer): API 결제 로그 ID ## API 요청: POST /rest/get_pccc ### 입력 - `tx_id` (string, 필수): req_pccc 응답의 트랜잭션 ID ### 응답 명세 ```json { "type": "object", "properties": { "data": { "type": "object", "properties": { "tx_id": { "type": "string", "description": "트랜잭션 ID" }, "status": { "type": "string", "description": "처리 상태pending: 인증 대기 (무과금)collecting: 조회 처리 중 (무과금)verified: 조회 완료 (과금)expired: 24시간 경과, 재인증 필요" }, "message": { "type": "string", "description": "상태 메시지 (pending 이면 \"인증 대기중입니다.\")발급된 부호가 없으면 \"조회된 개인통관고유부호가 없습니다.\"" }, "success": { "type": "integer", "description": "과금 여부0: 실패·승인 대기·부호 없음(무과금)1: 성공(과금)3: 실패(timeout)" }, "checked_at": { "type": "string", "description": "정보를 확인한 시각(ISO 8601, status 가 verified 일 때)" }, "개인통관고유부호": { "type": "string", "description": "개인통관고유부호 (status 가 verified 이고 부호가 있을 때)" }, "이름": { "type": "string", "description": "이름" }, "주소": { "type": "string", "description": "[우편번호] 기본주소 상세주소" }, "전화번호": { "type": "string", "description": "전화번호" }, "사용여부": { "type": "string", "description": "사용여부" }, "error": { "type": "string", "description": "처리 실패 시 오류 메시지" } }, "description": "조회 결과" }, "api": { "type": "object", "properties": { "success": { "type": "boolean", "description": "API 서버 정상 응답 여부" }, "cost": { "type": "integer", "description": "API 호출 요금" }, "ms": { "type": "integer", "description": "API 응답 시간" }, "pl_id": { "type": "integer", "description": "API 결제 로그 ID" } }, "description": "API 호출 공통 데이터" } } } ``` ### 정적 응답 예시 ```json { "data": { "tx_id": "9f2c4a7b1d8e35c60a4f7b2d1e9c80bb", "status": "pending", "message": "인증 대기중입니다.", "success": 0 }, "api": { "success": true, "cost": 0, "ms": 412, "pl_id": 4903 } } ``` ### 정적 응답 예시 ```json { "data": { "tx_id": "9f2c4a7b1d8e35c60a4f7b2d1e9c80bb", "status": "verified", "checked_at": "2026-09-19T20:14:07+09:00", "개인통관고유부호": "P211222441119", "이름": "홍길동", "주소": "[08020] 서울특별시 양천구 중앙로13길 100 201호", "전화번호": "01011112222", "사용여부": "사용", "success": 1 }, "api": { "success": true, "cost": 30, "ms": 2834, "pl_id": 4904 } } ``` ### 정적 응답 예시 ```json { "data": { "tx_id": "9f2c4a7b1d8e35c60a4f7b2d1e9c80bb", "status": "verified", "checked_at": "2026-09-19T20:14:07+09:00", "message": "조회된 개인통관고유부호가 없습니다.", "success": 0 }, "api": { "success": true, "cost": 0, "ms": 2648, "pl_id": 4905 } } ``` ### curl ```curl curl --fail-with-body --request POST 'https://apick.app/rest/get_pccc' \ --header "Authorization: Bearer $APICK_API_KEY" \ --form-string 'tx_id="9f2c4a7b1d8e35c60a4f7b2d1e9c80bb"' ``` ### Node.js (서버 ESM) ```javascript const form = new FormData(); form.append("tx_id", "\"9f2c4a7b1d8e35c60a4f7b2d1e9c80bb\""); const response = await fetch("https://apick.app/rest/get_pccc", { method: "POST", headers: { Authorization: "Bearer " + process.env.APICK_API_KEY }, body: form, signal: AbortSignal.timeout(120_000), }); if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`); const result = await response.json(); console.log(result); ``` ### python ```python import os import requests parts = [ ("tx_id", (None, "\"9f2c4a7b1d8e35c60a4f7b2d1e9c80bb\"")), ] response = requests.request("POST", "https://apick.app/rest/get_pccc", headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]}, files=parts, timeout=(10, 120)) response.raise_for_status() result = response.json() print(result) ``` ### php ```php '"9f2c4a7b1d8e35c60a4f7b2d1e9c80bb"', ]; $curl = curl_init('https://apick.app/rest/get_pccc'); curl_setopt_array($curl, [ CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => $headers, CURLOPT_POSTFIELDS => $form, CURLOPT_RETURNTRANSFER => true, CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120, ]); $body = curl_exec($curl); if ($body === false) { throw new RuntimeException(curl_error($curl)); } $status = curl_getinfo($curl, CURLINFO_HTTP_CODE); curl_close($curl); if ($status >= 400) { throw new RuntimeException($body); } $result = json_decode($body, true, 512, JSON_THROW_ON_ERROR); print_r($result); ``` ## 코드·오류 ## 상세 기능·요금 Method URL POST https://apick.app/rest/get_pccc tx_id 를 보내면 처리 상태를 확인합니다. 아직 승인 전이면 status 는 pending 이고 message 는 "인증 대기중입니다." 이며 과금되지 않습니다. 인증 접수는 req_pccc 로 먼저 해야 합니다. 이 API 는 tx_id 만 받습니다. 승인 완료 후 조회 결과는 24시간 동안 재조회할 수 있으며, 재조회할 때마다 과금됩니다. 응답의 checked_at 은 정보를 확인한 시각입니다. 인증이 완료되면 조회 결과를 다시 확인할 수 있으므로, 재조회할 때에는 다시 인증하지 않아도 됩니다. 조회는 정상 처리됐지만 발급된 부호가 없으면 message 는 "조회된 개인통관고유부호가 없습니다." 이고 success 는 0 이며 과금되지 않습니다. ## 상세 요청 Header 이름 필수 설명 Authorization O Bearer 인증키 ## 상세 응답 Body 이름 타입 설명 data Object 조회 결과 tx_id String 트랜잭션 ID status String 처리 상태pending: 인증 대기 (무과금)collecting: 조회 처리 중 (무과금)verified: 조회 완료 (과금)expired: 24시간 경과, 재인증 필요 message String 상태 메시지 (pending 이면 "인증 대기중입니다.")발급된 부호가 없으면 "조회된 개인통관고유부호가 없습니다." checked_at String 정보를 확인한 시각(ISO 8601, status 가 verified 일 때) 개인통관고유부호 String 개인통관고유부호 (status 가 verified 이고 부호가 있을 때) 이름 String 이름 주소 String [우편번호] 기본주소 상세주소 전화번호 String 전화번호 사용여부 String 사용여부 error String 처리 실패 시 오류 메시지 success Integer 과금 여부0: 실패·승인 대기·부호 없음(무과금)1: 성공(과금)3: 실패(timeout) api Object API 호출 공통 데이터 success Boolean API 서버 정상 응답 여부 cost Integer API 호출 요금 ms Integer API 응답 시간 pl_id Integer API 결제 로그 ID ## 상세 예제 요청 예시 (tx_id 로 상태 확인) form-data 전체 예제 보기 응답 예시 (인증 대기중) { "data": { "tx_id": "9f2c4a7b1d8e35c60a4f7b2d1e9c80bb", "status": "pending", "message": "인증 대기중입니다.", "success": 0 }, "api": { "success": true, "cost": 0, "ms": 412, "pl_id": 4903 } } 응답 예시 (조회 완료) { "data": { "tx_id": "9f2c4a7b1d8e35c60a4f7b2d1e9c80bb", "status": "verified", "checked_at": "2026-09-19T20:14:07+09:00", "개인통관고유부호": "P211222441119", "이름": "홍길동", "주소": "[08020] 서울특별시 양천구 중앙로13길 100 201호", "전화번호": "01011112222", "사용여부": "사용", "success": 1 }, "api": { "success": true, "cost": 30, "ms": 2834, "pl_id": 4904 } } 응답 예시 (부호 없음) { "data": { "tx_id": "9f2c4a7b1d8e35c60a4f7b2d1e9c80bb", "status": "verified", "checked_at": "2026-09-19T20:14:07+09:00", "message": "조회된 개인통관고유부호가 없습니다.", "success": 0 }, "api": { "success": true, "cost": 0, "ms": 2648, "pl_id": 4905 } }