{"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":{"/in0076000264":{"post":{"tags":["홈택스 API"],"summary":"사업자상태조회(주민등록번호)","operationId":"IN0076000264","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/im.hyphen.market.infotech.dao.req.IN0076000264Req"}}},"required":true},"responses":{"404":{"description":"Not Found","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/im.hyphen.market.common.entity.ProcessResult"}}}}},"servers":[{"url":"https://api.hyphen.im","description":"Production Server"},{"url":"http://localhost:9092","description":"Production Server"}]}},"/in0076000263":{"post":{"tags":["홈택스 API"],"summary":"사업자상태조회(사업자번호)","operationId":"in0076000263","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/im.hyphen.market.infotech.dao.req.IN0076000263Req"}}},"required":true},"responses":{"404":{"description":"Not Found","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IN0076000263Resp"}}}}},"servers":[{"url":"https://api.hyphen.im","description":"Production Server"},{"url":"http://localhost:9092","description":"Production Server"}]}}},"components":{"schemas":{"im.hyphen.market.infotech.dao.req.IN0076000264Req":{"required":["bizNo","loginMethod"],"type":"object","properties":{"loginMethod":{"type":"string","description":"로그인구분(CERT: 인증서, EASY: 간편 로그인)"},"signCert":{"type":"string","description":"인증서정보(인증서PEM 문자열) *인증서로그인 필수 - 공인인증서모듈설치 필요"},"signPri":{"type":"string","description":"개인키정보(개인키PEM 문자열) *인증서로그인 필수 - 공인인증서모듈설치 필요"},"signPw":{"type":"string","description":"인증서 비밀번호 *인증서로그인 signPw 또는 signPwEnc필수"},"signPwEnc":{"type":"string","description":"(암호화)인증서 비밀번호 *인증서로그인 signPw 또는 signPwEnc필수"},"loginOrgCd":{"type":"string","description":"간편로그인 기관 구분(pass : PASS인증, kakao : 카카오톡, kakaobank : 카카오뱅크, kica : 삼성패스, kb : KB스타뱅킹, naver : 네이버, shinhan : 신한인증서, hana : 하나은행, nh : NH인증서, toss : 토스인증서, banksalad : 뱅크샐러드, woori : 우리인증서, dream : 드림인증) *간편로그인시 필수"},"resNm":{"type":"string","description":"이름 *간편로그인 resNm 또는 resNmEnc 필수"},"resNmEnc":{"type":"string","description":"(암호화)이름 *간편로그인 resNm 또는 resNmEnc 필수"},"resNo":{"type":"string","description":"생년월일(8자리) *간편로그인시 필수"},"mobileCo":{"type":"string","description":"통신사(S: SKT, K: KT, L: LGT) *간편로그인 'PASS인증' 시 필수, 알뜰통신사도 동일"},"mobileNo":{"type":"string","description":"휴대폰번호 *간편로그인 mobileNo 또는 mobileNoEnc 필수"},"mobileNoEnc":{"type":"string","description":"(암호화)휴대폰번호 *간편로그인 mobileNo 또는 mobileNoEnc 필수"},"stepMode":{"type":"string","description":"간편로그인 단계 구분(step: 2단계(요청->로그인)로 나눠 진행, nostep: 1단계로 진행) *간편로그인 시 필수"},"step":{"type":"string","description":"간편로그인 단계(init: 간편인증 요청(step1), sign: 간편인증 후 로그인(step2)) *간편로그인 시 stepMode가 'step'인 경우 필수"},"stepData":{"type":"string","description":"로그인 사용데이터(내부용) *step 1 결과의 'stepData'를 그대로 입력 / 간편로그인시 stepMode가 'step'인 경우 필수"},"showCookie":{"type":"string","description":"세션정보 요청 구분(Y: 세션정보 가져오기) *결과값에 'cookie' 데이터 리턴"},"cookieData":{"type":"string","description":"세션정보 입력(입력 시 해당 세션정보 재사용) *계속 유지를 원할 시 조회마다 나오는 'cookie'값을 새로 세팅해야 함"},"bizNo":{"type":"string","description":"주민등록번호 *bizNo 또는 bizNoEnc 필수"},"bizNoEnc":{"type":"string","description":"(암호화)주민등록번호 *bizNo 또는 bizNoEnc 필수"},"agrDt":{"type":"string","description":"조회 동의일자(yyyymmdd) - 입력하지 않을 시 조회일을 자동으로 입력"}}},"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":"오류메세지"}}},"im.hyphen.market.common.entity.ProcessResult":{"type":"object","properties":{"common":{"$ref":"#/components/schemas/RespCommon"},"data":{"type":"object"}}},"im.hyphen.market.infotech.dao.req.IN0076000263Req":{"required":["bizNo"],"type":"object","properties":{"bizNo":{"type":"string","description":"사업자번호"}}},"IN0076000263":{"required":["bizNo","changeDt","closeDt","errMsg","errYn","reqCd","searchDt","searchDttm","searchIntervalSecond","taxMsg","taxSt","taxTypeCd","taxTypeNm"],"type":"object","properties":{"taxSt":{"type":"string","description":"사업상태(00 - 정상 01 - 폐업 02 - 휴업 90 - 미등록사업자)"},"taxTypeCd":{"type":"string","description":"과세유형코드(01 부가가치세 일반과세자 02 부가가치세 간이과세자 03 부가가치세 면세과세자 06 비영리법인 07 부가가치세 과특사업자 12 간이과세자(세금계산서발급))"},"taxTypeNm":{"type":"string","description":"과세유형 한글명"},"closeDt":{"type":"string","description":"폐업일"},"changeDt":{"type":"string","description":"과세유형 전환일자"},"searchDt":{"type":"string","description":"조회일자"},"bizNo":{"type":"string","description":"조회사업자번호"},"taxMsg":{"type":"string","description":"과세유형 메시지"},"errMsg":{"type":"string","description":"에러 메시지"},"reqCd":{"type":"string","description":"요청 코드"},"errYn":{"type":"string","description":"에러 여부"},"searchIntervalSecond":{"type":"string","description":"searchIntervalSecond"},"searchDttm":{"type":"string","description":"searchDttm"}},"description":"개별부 데이터"},"IN0076000263Resp":{"type":"object","properties":{"common":{"$ref":"#/components/schemas/RespCommon"},"data":{"$ref":"#/components/schemas/IN0076000263"}}}}}}