{"openapi": "3.1.0", "info": {"title": "기업뷰 Company API", "version": "1.0.0", "description": "회사명, 사업자등록번호 또는 대표자명으로 통합 기업정보를 조회합니다."}, "servers": [{"url": "https://company-api.sellday.kr"}], "paths": {"/api/v1/company": {"get": {"summary": "기업 통합정보 조회", "parameters": [{"name": "name", "in": "query", "schema": {"type": "string"}, "description": "정확한 회사명"}, {"name": "businessNumber", "in": "query", "schema": {"type": "string", "pattern": "^[0-9]{10}$"}}, {"name": "representativeName", "in": "query", "schema": {"type": "string"}, "description": "정확한 대표자명"}], "responses": {"200": {"description": "기업 기본정보·재무·조달정보"}, "400": {"description": "잘못된 요청"}, "404": {"description": "검색 결과 없음"}, "409": {"description": "동명이인 또는 유사 회사 후보 존재"}}}}, "/api/v1/search": {"get": {"summary": "회사명 후보 검색", "parameters": [{"name": "q", "in": "query", "schema": {"type": "string"}}, {"name": "field", "in": "query", "schema": {"type": "string", "enum": ["company", "business", "representative", "address", "product"]}}, {"name": "name", "in": "query", "schema": {"type": "string"}}, {"name": "businessNumber", "in": "query", "schema": {"type": "string"}}, {"name": "representativeName", "in": "query", "schema": {"type": "string"}}], "responses": {"200": {"description": "회사 후보 목록"}}}}, "/api/v1/companies/search": {"get": {"summary": "사업자번호 기준 기업 검색", "description": "회사명(q), 대표자명(representative), 상품명(product) 중 하나로 검색합니다.", "parameters": [{"name": "q", "in": "query", "schema": {"type": "string"}, "description": "회사명(주식회사/(주)/공백 정규화)"}, {"name": "representative", "in": "query", "schema": {"type": "string"}}, {"name": "product", "in": "query", "schema": {"type": "string"}}, {"name": "businessNumber", "in": "query", "schema": {"type": "string", "pattern": "^[0-9]{10}$"}}, {"name": "address", "in": "query", "schema": {"type": "string"}}], "responses": {"200": {"description": "사업자번호로 식별되는 기업 후보 목록"}, "400": {"description": "검색 파라미터 오류"}}}}, "/api/v1/companies/{businessNumber}": {"get": {"summary": "사업자번호 기준 기업 통합정보 조회", "parameters": [{"name": "businessNumber", "in": "path", "required": true, "schema": {"type": "string", "pattern": "^[0-9]{10}$"}}], "responses": {"200": {"description": "기업 통합정보"}, "404": {"description": "검색 결과 없음"}}}}, "/api/v1/dart-records": {"get": {"summary": "사업자번호 기준 OpenDART 상세 레코드 조회", "parameters": [{"name": "businessNumber", "in": "query", "required": true, "schema": {"type": "string", "pattern": "^[0-9]{10}$"}}, {"name": "dataset", "in": "query", "schema": {"type": "string"}}, {"name": "limit", "in": "query", "schema": {"type": "integer", "minimum": 1, "maximum": 500, "default": 100}}, {"name": "offset", "in": "query", "schema": {"type": "integer", "minimum": 0, "default": 0}}], "responses": {"200": {"description": "사업자번호에 연결된 DART 레코드 페이지"}}}}}}