{"openapi":"3.0.3","info":{"title":"APICK 공시 이벤트 분석","version":"1.0.0","description":"회사 고유번호·기간·공시유형으로 전자공시 목록을 조회합니다. 고유번호를 주면 회사의 공시를 기간으로 좁혀 보고, 고유번호 없이 기간만 주면 전체 공시를 훑습니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/dart_disclosure":{"post":{"summary":"공시 이벤트 분석","description":"회사 고유번호·기간·공시유형으로 전자공시 목록을 조회합니다. 고유번호를 주면 회사의 공시를 기간으로 좁혀 보고, 고유번호 없이 기간만 주면 전체 공시를 훑습니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"items":{"type":"array","items":{}},"totalCount":{"type":"integer"},"pageNo":{"type":"integer"},"numOfRows":{"type":"integer"}}},"api":{"type":"object","properties":{"cost":{"type":"integer"},"success":{"type":"boolean"},"ms":{"type":"integer"}}}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":false,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"corpCode":{"type":"string","description":"기업 고유번호 (8자리) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"00126380"},"startDate":{"type":"string","description":"조회 시작일 (YYYYMMDD) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"20260101"},"endDate":{"type":"string","description":"조회 종료일 (YYYYMMDD) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"20260331"},"pageNo":{"type":"string","description":"페이지 번호 (기본 1) 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (integer)"},"numOfRows":{"type":"string","description":"페이지당 결과 수 (기본 10, 최대 100) 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (integer)"}}}}}}}}},"x-code-tables":[{"title":"응답과 오류 복구","columns":["필드","타입","설명"],"rows":[["data.items[]","array","공시 목록입니다. 접수번호·공시명·제출인·접수일자 등 항목 이름은 원문 표기를 그대로 씁니다."],["data.totalCount","integer","조건에 맞는 전체 건수입니다."],["data.pageNo","integer","이번 응답의 페이지 번호입니다."],["data.numOfRows","integer","이번 응답의 항목 수입니다."],["api.cost","integer","차감된 포인트입니다. 실패하거나 결과가 없으면 0입니다."],["api.ms","integer","처리 시간(밀리초)입니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}