{"openapi":"3.0.3","info":{"title":"APICK 사업자·입찰 이력 묶음","version":"1.0.0","description":"biz_detail, ecommerce_registration, debarred_company, bid_notice, bid_award 을(를) 한 번의 요청으로 함께 조회합니다. 구성원마다 결과가 성공·실패로 나뉘어 돌아옵니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/data_result_company_bid_bundle":{"post":{"summary":"사업자·입찰 이력 묶음","description":"biz_detail, ecommerce_registration, debarred_company, bid_notice, bid_award 을(를) 한 번의 요청으로 함께 조회합니다. 구성원마다 결과가 성공·실패로 나뉘어 돌아옵니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"success":{"type":"boolean","description":"성공한 구성원이 하나 이상이면 true 입니다."},"product":{"type":"string","description":"묶음 상품 코드(company_bid_bundle)"},"members":{"type":"array","items":{"type":"string"},"description":"이 묶음에 담긴 구성원 코드 목록입니다."},"results":{"type":"object","properties":{"biz_detail":{"type":"object","properties":{}},"ecommerce_registration":{"type":"object","properties":{}},"debarred_company":{"type":"object","properties":{}},"bid_notice":{"type":"object","properties":{}},"bid_award":{"type":"object","properties":{}}},"description":"성공한 구성원의 응답 본문. 구성원 코드를 키로 담깁니다."},"failures":{"type":"object","properties":{"ecommerce_registration":{"type":"string"}},"description":"실패한 구성원의 오류. 구성원 코드를 키로, 안내 문구를 값으로 담습니다. 실패가 없으면 빈 객체 {} 입니다."}}},"api":{"type":"object","properties":{"success":{"type":"boolean","description":"성공한 구성원이 하나 이상이면 true 입니다."},"cost":{"type":"integer","description":"API 호출 요금"},"ms":{"type":"integer","description":"API 응답 시간"},"pl_id":{"type":"integer","description":"API 결제 로그 ID"}},"description":"API 호출 공통 데이터"}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":false,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"biz_no":{"type":"string","description":"사업자등록번호 10자리입니다. 사업자정보·통신판매업 신고 조회에 씁니다. (string)","example":"…"},"bizno":{"type":"string","description":"사업자등록번호 10자리입니다(부정당제재 조회가 쓰는 이름). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"…"},"startDate":{"type":"string","description":"입찰공고·낙찰 조회 시작 일시입니다(<code>YYYYMMDD</code>·<code>YYYYMMDDHHMM</code>). <code>bidNtceNo</code>가 없으면 <code>endDate</code>와 함께 필요합니다. (string)","example":"…"},"endDate":{"type":"string","description":"입찰공고·낙찰 조회 종료 일시입니다. 시작일과의 차이는 31일 이하입니다. (string)","example":"…"},"bidNtceNo":{"type":"string","description":"입찰공고번호입니다. 보내면 그 공고만 조회합니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"…"},"bizType":{"type":"string","description":"업무구분입니다(물품·공사·용역·외자). 낙찰 조회에 쓰며 기본 <code>용역</code>입니다. (string)","example":"…"},"indstrytyCd":{"type":"string","description":"업종코드(숫자)입니다. 낙찰 조회에 씁니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"…"},"pageNo":{"type":"string","description":"페이지 번호입니다. 기본 <code>1</code>입니다. 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (integer)","example":"…"},"numOfRows":{"type":"string","description":"한 페이지 결과 수입니다. 기본 <code>10</code>입니다. 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (integer)","example":"…"}}}}}}}}},"x-code-tables":[{"title":"오류와 복구","columns":["상황","HTTP","오류 코드","해결"],"rows":[["구성원 일부가 실패","200","— (failures.<구성원>에 오류 문구)","성공한 구성원 결과는 그대로 받고, 실패한 구성원의 입력을 확인해 다시 요청합니다."],["구성원 전부가 실패","200","— (success: false)","failures 의 안내를 확인해 입력을 고친 뒤 다시 요청합니다."],["이 묶음을 이용할 수 없는 상태","503","NATIVE_BUNDLE_UNAVAILABLE","잠시 뒤 다시 요청합니다. 이 상품을 계속 쓸 수 없으면 문의게시판으로 알려주세요."],["서버 처리 오류","500","NATIVE_BUNDLE_FAILED","잠시 뒤 다시 요청합니다. 반복되면 문의게시판으로 알려주세요."],["/rest/req_<묶음> 으로 호출","400","NATIVE_BUNDLE_NO_AUTH","이 묶음은 인증요청 단계가 없습니다. /rest/data_result_company_bid_bundle 로 요청합니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}