{
  "swagger": "2.0",
  "info": {
    "title": "나라장터 입찰공고 조회",
    "version": "1.0",
    "description": "조달청 나라장터 입찰공고정보서비스 — 용역 입찰공고(RFP) 목록 조회 (실습용 예시 · 실제 사용 전 공공데이터포털 활용가이드로 basePath·파라미터 확인 필수)"
  },
  "host": "apis.data.go.kr",
  "basePath": "/1230000/ad/BidPublicInfoService",
  "schemes": ["https"],
  "paths": {
    "/getBidPblancListInfoServcPPSSrch": {
      "get": {
        "operationId": "GetBidNotices",
        "summary": "용역 입찰공고 목록 조회",
        "description": "기간과 검색어로 나라장터 용역 입찰공고(RFP) 목록을 조회한다. 공고명·발주기관·마감일시·예산금액을 반환한다",
        "parameters": [
          { "name": "serviceKey", "in": "query", "required": true, "type": "string", "description": "공공데이터포털 발급 서비스 키" },
          { "name": "pageNo", "in": "query", "type": "string", "default": "1", "description": "페이지 번호" },
          { "name": "numOfRows", "in": "query", "type": "string", "default": "10", "description": "페이지당 결과 수" },
          { "name": "inqryDiv", "in": "query", "required": true, "type": "string", "default": "1", "description": "조회 구분(1: 공고게시일시 기준)" },
          { "name": "inqryBgnDt", "in": "query", "required": true, "type": "string", "default": "202608010000", "description": "조회 시작일시(YYYYMMDDHHMM)" },
          { "name": "inqryEndDt", "in": "query", "required": true, "type": "string", "default": "202608312359", "description": "조회 종료일시(YYYYMMDDHHMM)" },
          { "name": "bidNtceNm", "in": "query", "type": "string", "description": "공고명 검색어(예: 콜센터, AICC, 시스템 구축)" },
          { "name": "type", "in": "query", "type": "string", "default": "json", "description": "응답 형식(json/xml)" }
        ],
        "responses": { "200": { "description": "입찰공고 목록(JSON)" } }
      }
    }
  }
}