{"openapi":"3.0.3","info":{"title":"APICK 개인통관고유부호 조회","version":"1.0.0","description":"req_pccc 로 받은 tx_id 로 처리 상태를 확인합니다. 사용자가 승인하기 전에는 인증 대기 상태를 돌려주고, 승인되면 개인통관고유부호와 주소를 반환합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/get_pccc":{"post":{"summary":"개인통관고유부호 조회","description":"req_pccc 로 받은 tx_id 로 처리 상태를 확인합니다. 사용자가 승인하기 전에는 인증 대기 상태를 돌려주고, 승인되면 개인통관고유부호와 주소를 반환합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"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 호출 공통 데이터"}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"tx_id":{"type":"string","description":"req_pccc 응답의 트랜잭션 ID (string)","example":"\"9f2c4a7b1d8e35c60a4f7b2d1e9c80bb\""}},"required":["tx_id"]}}}}}}},"x-code-tables":[],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}