{"openapi":"3.0.3","info":{"title":"APICK 나라장터 낙찰정보 조회","version":"1.0.0","description":"업무구분·기간·공고번호로 나라장터 개찰·낙찰 결과를 조회합니다. 입찰공고와 같은 조건 체계를 쓰므로 공고번호로 두 결과를 이어 볼 수 있습니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/bid_award":{"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":{"bizType":{"type":"string","description":"업무구분 (물품·공사·용역·외자, 기본 용역) (string)","enum":["물품","공사","용역","외자"],"example":"공사"},"startDate":{"type":"string","description":"조회 시작일 (YYYYMMDD 또는 YYYYMMDDHHMM) (string)"},"endDate":{"type":"string","description":"조회 종료일 (YYYYMMDD 또는 YYYYMMDDHHMM) (string)"},"bidNtceNo":{"type":"string","description":"입찰공고번호 (지정 시 공고번호로 조회) (string)","example":"R26BK00000000"},"indstrytyCd":{"type":"string","description":"업종코드 (선택) (string)"},"pageNo":{"type":"string","description":"페이지 번호 (기본 1) (integer)"},"numOfRows":{"type":"string","description":"페이지당 결과 수 (기본 10, 최대 999) (integer)","example":"20"}}}}}}}}},"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"}}}}