{"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 중 하나입니다."},"message":{"type":"string","description":"대기·준비 중이면 상태 안내, 발급된 부호가 없으면 조회된 개인통관고유부호가 없습니다.입니다. 조회 완료 응답에는 없습니다."},"success":{"type":"integer","description":"1: 부호를 돌려준 과금 응답, 0: 대기·부호 없음·실패(과금 없음)."},"checked_at":{"type":"string","description":"정보를 확인한 시각(ISO 8601, 한국시간 +09:00)입니다. verified일 때 옵니다. 재조회 기한(24시간)의 기준입니다."},"개인통관고유부호":{"type":"string","description":"P로 시작하는 13자리 개인통관고유부호입니다."},"이름":{"type":"string","description":"부호에 등록된 이름입니다."},"주소":{"type":"string","description":"[우편번호] 기본주소 상세주소 형식입니다. 등록된 주소가 없으면 빈 문자열입니다."},"전화번호":{"type":"string","description":"부호에 등록된 전화번호입니다."},"사용여부":{"type":"string","description":"부호의 사용 상태입니다. 예: 사용. 사용 중이 아니면 통관에 쓸 수 없으니 사용자에게 재발급을 안내하세요."}}},"api":{"type":"object","properties":{"success":{"type":"boolean"},"cost":{"type":"integer","description":"차감된 포인트입니다."},"ms":{"type":"integer"},"pl_id":{"type":"integer","description":"결제 기록 번호입니다. 과금 없는 대기·부호 없음 응답은 -1입니다."}}}}}}}},"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":[{"title":"오류와 복구","columns":["상황","HTTP","data.error","해결"],"rows":[["tx_id가 없거나 32자리 영소문자·숫자가 아님","400","입력 항목이 잘못됐습니다.(tx_id)","req_pccc 응답의 값을 그대로 넣습니다."],["없는 tx_id이거나 다른 계정의 요청","404","요청을 찾을 수 없습니다.","req_pccc를 호출한 계정의 API 키로 조회합니다."],["5분 안에 승인하지 않아 인증 만료","410","인증 시간이 초과되었습니다.","req_pccc부터 다시 진행합니다. API 인증키 문제가 아니므로 키를 바꾸지 마세요."],["결과 재조회 기간(24시간)이 지남","410","조회 유효기간이 지났습니다. 다시 인증해 주세요.","req_pccc부터 다시 진행합니다. API 인증키 문제가 아닙니다."],["사용자가 휴대폰에서 인증을 거부함","403","인증이 거부되었습니다.","과금되지 않습니다. 사용자에게 확인한 뒤 req_pccc부터 다시 진행합니다."],["조회하지 못함","424","서비스 요청에 실패했습니다.","사용자에게 확인한 뒤 req_pccc부터 다시 진행합니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}