{"openapi":"3.0.3","info":{"title":"APICK 개인통관고유부호 인증 요청","version":"1.0.0","description":"이름·생년월일·휴대전화번호와 간편인증 방식을 입력하면 사용자에게 간편인증 요청을 보내고, 결과 조회에 사용할 tx_id 를 즉시 반환합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/req_pccc":{"post":{"summary":"개인통관고유부호 인증 요청","description":"이름·생년월일·휴대전화번호와 간편인증 방식을 입력하면 사용자에게 간편인증 요청을 보내고, 결과 조회에 사용할 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: 인증 대기)"},"message":{"type":"string","description":"상태 메시지 (고정값: \"인증 대기중입니다.\")"},"provider":{"type":"string","description":"사용한 간편인증 방식"},"expires_at":{"type":"string","description":"인증 유효 기한(ISO 8601). 이 시각까지 승인하지 못하면 인증 실패 처리됩니다."},"success":{"type":"integer","description":"과금 여부0: 실패 또는 재사용(무과금)1: 발송 성공(과금)3: 실패(timeout)"}},"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":{"name":{"type":"string","description":"이름 (string)","example":"\"홍길동\""},"birthday":{"type":"string","description":"생년월일 8자리 (YYYYMMDD) (string)","example":"\"19900101\""},"phone":{"type":"string","description":"휴대전화 번호 (본인 명의, 숫자만) (string)","example":"\"01011112222\""},"provider":{"type":"string","description":"간편인증 방식 (kakao, naver, toss, pass, samsung, kb, shinhan, hana, woori, ibk, nh, kakaobank, banksalad) (string)","example":"\"kakao\""}},"required":["name","birthday","phone","provider"]}}}}}}},"x-code-tables":[],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}