{"openapi":"3.0.1","info":{"title":"API 마켓 개발가이드","description":"API 명세서 및 테스트베드 확인으로 빠르게 연동해보세요<br>본 마켓은 거래되는 데이터의 내용을 보관, 관리하지 않으며, 제공기관과 이용자 간 전달만을 지원합니다.","version":"1.0"},"servers":[{"url":"https://api.hyphen.im","description":"Production Server"},{"url":"http://localhost:9092","description":"test Server"}],"paths":{"/in0004000158":{"post":{"tags":["인터넷등기소 API"],"summary":"법인등기 상호조회","operationId":"in0004000158","parameters":[{"name":"hyphen-gustation","in":"header","description":"실 사용시엔 이 필드를 제거하세요","required":true,"schema":{"type":"string","example":"Y"}},{"name":"user-id","in":"header","description":"회원ID(회원가입시 생성)","required":true,"schema":{"type":"string"}},{"name":"Hkey","in":"header","description":"H보안키(회원가입 후 이메일로 전달)","required":true,"schema":{"type":"string"}},{"name":"user-tr-no","in":"header","description":"거래고유번호(고객 생성)","schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IN0004000158Req"}}},"required":true},"responses":{"404":{"description":"Not Found","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IN0004000158Resp"}}}}},"servers":[{"url":"https://api.hyphen.im","description":"Production Server"},{"url":"http://localhost:9092","description":"Production Server"}]}},"/in0004000156":{"post":{"tags":["인터넷등기소 API"],"summary":"법인등기 법인검색","operationId":"in0004000156","parameters":[{"name":"hyphen-gustation","in":"header","description":"실 사용시엔 이 필드를 제거하세요","required":true,"schema":{"type":"string","example":"Y"}},{"name":"user-id","in":"header","description":"회원ID(회원가입시 생성)","required":true,"schema":{"type":"string"}},{"name":"Hkey","in":"header","description":"H보안키(회원가입 후 이메일로 전달)","required":true,"schema":{"type":"string"}},{"name":"user-tr-no","in":"header","description":"거래고유번호(고객 생성)","schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IN0004000156Req"}}},"required":true},"responses":{"404":{"description":"Not Found","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IN0004000156Resp"}}}}},"servers":[{"url":"https://api.hyphen.im","description":"Production Server"},{"url":"http://localhost:9092","description":"Production Server"}]}}},"components":{"schemas":{"IN0004000158Req":{"required":["userId","userPw"],"type":"object","properties":{"userId":{"type":"string","description":"인터넷등기소 아이디"},"userPw":{"type":"string","description":"인터넷등기소 비밀번호"},"showCookie":{"type":"string","description":"세션정보 요청 구분(Y : 세션정보 가져오기) *출력 데이터의 \"cookieData\"에 세션정보 리턴"},"cookieData":{"type":"string","description":"세션정보 입력(입력 시 해당 세션정보 재사용) * 계속 유지를 원할 시 조회마다 나오는   \"cookieData\" 값을 새로 세팅해야 함"},"searchDiv":{"type":"string","description":"조회구분(1:상호로찾기)"},"searchTxt":{"type":"string","description":"검색어"},"closeGb":{"type":"string","description":"폐쇄등기기록 포함여부(Y/N) *기본값:N"},"jumalGb":{"type":"string","description":"주말된 상호 포함여부(Y/N) *기본값:N"},"regtno":{"type":"string","description":"관할등기소 코드 *미입력시 전체 등기소"},"timeInterval":{"type":"string","description":"상세조회 간격시간(상세조회일 경우 적용, 기본값:300)"},"regOfficeNm":{"type":"string","description":"등기소코드 *특정상호 1개만 조회할 경우 필수"},"regDivNm":{"type":"string","description":"법인구분명 코드 *특정상호 1개만 조회할 경우 필수"},"regSeqNo":{"type":"string","description":"등기번호 *특정상호 1개만 조회할 경우 필수"}}},"IN0004000158":{"required":["totalCnt"],"type":"object","properties":{"totalCnt":{"type":"string","description":"검색된 건수"},"list":{"type":"array","items":{"$ref":"#/components/schemas/ListResp"}},"cookieData":{"type":"string","description":"세션정보 입력(입력 시 해당 세션정보 재사용) * 계속 유지를 원할 시 조회마다 나오는   \"cookieData\" 값을 새로 세팅해야 함"}},"description":"개별부 data"},"IN0004000158Resp":{"type":"object","properties":{"common":{"$ref":"#/components/schemas/RespCommon"},"data":{"$ref":"#/components/schemas/IN0004000158"}}},"ListResp":{"type":"object","properties":{"regOfficeCd":{"type":"string","description":"관할등기소 코드"},"regOfficeNm":{"type":"string","description":"관할등기소명"},"regDivCd":{"type":"string","description":"법인구분코드"},"regDivNm":{"type":"string","description":"법인구분명"},"regSeqNo":{"type":"string","description":"등기번호"},"brandNm":{"type":"string","description":"상호"},"hdShopCd":{"type":"string","description":"본/지점 코드(1:본점 / 2:지점)"},"hdShopNm":{"type":"string","description":"본/지점"},"hdShopAddr":{"type":"string","description":"본/지점 주소"},"closeYn":{"type":"string","description":"폐쇄여부"},"shMalsoYn":{"type":"string","description":"말소여부"},"jumalYn":{"type":"string","description":"주말여부"},"dRegNo":{"type":"string","description":"상세 법인등록번호"},"dBrandNm":{"type":"string","description":"상세 상호"},"dStatus":{"type":"string","description":"상세 등기상태"}}},"RespCommon":{"type":"object","properties":{"userTrNo":{"type":"string","description":"사용자 거래고유번호(사용자 생성)"},"hyphenTrNo":{"type":"string","description":"하이픈 고유거래번호(하이픈 생성)"},"errYn":{"type":"string","description":"오류여부(Y : 오류, N : 정상)"},"errCd":{"type":"string","description":"오류코드"},"errMsg":{"type":"string","description":"오류메세지"}},"description":"공통부 common"},"IN0004000156Req":{"required":["regStatus","searchDiv","searchTxt","userId","userPw"],"type":"object","properties":{"userId":{"type":"string","description":"인터넷등기소 아이디"},"userPw":{"type":"string","description":"인터넷등기소 비밀번호"},"showCookie":{"type":"string","description":"세션정보 요청 구분(Y : 세션정보 가져오기) *출력 데이터의 \"cookieData\"에 세션정보 리턴"},"cookieData":{"type":"string","description":"세션정보 입력(입력 시 해당 세션정보 재사용) * 계속 유지를 원할 시 조회마다 나오는   \"cookieData\" 값을 새로 세팅해야 함"},"searchDiv":{"type":"string","description":"조회구분(1:등록번호로찾기,2:상호로찾기,3:등기번호로찾기)"},"regStatus":{"type":"string","description":"등기부상태 (0 : 전체 등기부상태, 1 : 살아있는 등기, 2 : 회사정리절차개시결정, 3 : 본점전출, 4 : 해산, 5 : 합병해산, 6 : 청산종결, 7 : 기타폐쇄, 8 : 상호폐지, 9 : 해산간주, 10 : 청산종결간주, 11 : 파산, 12 : 분할합병해산, 13 : 분할해산, 14 : 조직변경해산, 15 : 보전관리, 16 : 회생절차, 17 : 종료)"},"searchTxt":{"type":"string","description":"법인등록번호/상호명/등기번호"},"masterjiGb":{"type":"string","description":"본지점구분(0:전체,1:본점,2:지점) *미입력시 전체"},"regOfficeCd":{"type":"string","description":"관할등기소코드(등기번호로 검색시 필수)"},"regDivCd":{"type":"string","description":"법인구분코드(등기번호로 검색시 필수)"}}},"DataList":{"type":"object","properties":{"regOfficeCd":{"type":"string","description":"관할등기소 코드"},"regOfficeNm":{"type":"string","description":"관할등기소명"},"regDivCd":{"type":"string","description":"법인구분코드"},"regDivNm":{"type":"string","description":"법인구분명"},"regSeqNo":{"type":"string","description":"등기번호"},"brandNm":{"type":"string","description":"상호"},"hdShopCd":{"type":"string","description":"본/지점 코드(1:본점 / 2:지점)"},"hdShopNm":{"type":"string","description":"본/지점"},"jumalYn":{"type":"string","description":"주말여부"},"closeYn":{"type":"string","description":"폐쇄여부"},"dRegNo":{"type":"string","description":"상세 법인등록번호"},"dBrandNm":{"type":"string","description":"상세 상호"},"dStatus":{"type":"string","description":"상세 등기상태"}}},"IN0004000156":{"required":["totalCnt"],"type":"object","properties":{"totalCnt":{"type":"string","description":"검색된 건수"},"list":{"type":"array","items":{"$ref":"#/components/schemas/DataList"}},"cookieData":{"type":"string","description":"세션정보 입력(입력 시 해당 세션정보 재사용) * 계속 유지를 원할 시 조회마다 나오는   \"cookieData\" 값을 새로 세팅해야 함"}},"description":"개별부 데이터"},"IN0004000156Resp":{"type":"object","properties":{"common":{"$ref":"#/components/schemas/RespCommon"},"data":{"$ref":"#/components/schemas/IN0004000156"}}}}}}