스마트팜코리아

OPEN API 신청확인 테이블 - 사용자 이름, API 신청 패스워드, API key, API 승인여부, 업체(기관)명, 부서, 직급(지위), 사용자 연락처, 사용자 Email, 사업(연구)명, 추진기간, 주무부처/기관, 예산, API 사용목적, 필요정보, 활용내용, 도출시기, API 신청일자로 구성
첨부파일
사유입력

데이터 마트

데이터 설명 : 시설원예 환경/제어/생육/경영 데이터마트 개방데이터 (농가기준 조회)
데이터 수집년도 : 2015년 ~ 2024년
데이터 제공 농가수 / 작기수 : 196호 / 596작기
업데이트 주기 : 년 (작기종료 후 적재)

Open API 메타정보

Open API 메타정보 - 기능명, WSDL, URL, 제공방식, 데이터 포맷, 서비스 버전, 배포일자, 기술문서, Open API 신청/확인
기능명	품목별 데이터셋 제공 서비스
WSDL	http://www.smartfarmkorea.net/Agree_WS/webservices/DataMartItemService?wsdl
URL	http://www.smartfarmkorea.net/Agree_WS/webservices/DataMartItemRestService/
제공방식	SOAP, REST	데이터 포맷	XML, JSON
서비스 버전	2.0	배포일자	2019.05.31
기술문서	데이터셋정의서	Open API 신청/확인

Open API 요청인자

오퍼레이션 목록 - 변수명, 요청인자타입, 샘플데이터, 설명, 비고
변수명	요청인자타입	샘플데이터	설명	비고
serviceKey	String	SERVICE_KEY	서비스 키

출력항목
SAMPLE URL
SAMPLE DATA
결과메세지

출력항목

출력항목 - 항목, 항목인자타입, 샘플데이터, 항목명, 비고
항목	항목인자타입	샘플데이터	항목명	비고
fcltyId	String	PFS_0000001_01	농가 ID
crpsnSn	Integer	79	작기 일련번호
fcltyYear	String	2015	작기 관리 년도	형식 : yyyy
itemCode	String	080300	품목코드
itemCodeNm	String	토마토	품목명
spciesCode	String	999	품종코드
spciesCodeNm	String	데프니스	품종명
scspnMltspnSeCode	String	B0001000000000000002	단동/연동 구분코드
scspnMltspnSeCodeNm	String	연동	단동/연동명
ctvtAr	Integer	3894	재배 면적	단위 : ㎡
ctvtArNm	String	대규모	온실 규모
fcltySidoCode	String	4800000000	시도 코드
fcltySidoCodeNm	String	경상남도	시도명
fcltySigunguCode	String	4824000000	시군구 코드
fcltySigunguCodeNm	String	사천시	시군구명
fcltyTyCode	String	B0002000000000000001	시설 유형 코드
fcltyTyCodeNm	String	비닐	시설 유형명
ctvtMthdCode	String	B0004000000000000002	재배 형태 코드
ctvtMthdCodeNm	String	수경	재배 형태명

SAMPLE URL - 번호, 출력명, URL
번호	출력명	URL
1	농가 정보	http://www.smartfarmkorea.net/Agree_WS/webservices/DataMartItemRestService/getFcltyInfoDataList/{serviceKey}

SAMPLE DATA - 사용자 ID, 시설 ID, 지역명
농가 ID	작기 일련번호	작기 관리 년도	품목코드	품목명	품종코드	품종명	단동/연동 구분코드	단동/연동명	재배 면적	온실 규모	시도 코드	시도 코드명	시군구 코드	시군구명	시설 유형 코드	시설 유형명	재배 형태 코드	재배 형태명
PFS_0000001_01	79	2015	080300	토마토	999	데프니스	B0001000000000000002	연동	3894	대규모	4800000000	경상남도	4824000000	사천시	B0002000000000000001	비닐	B0004000000000000002	수경

Open API 요청인자

오퍼레이션 목록 - 변수명, 요청인자타입, 샘플데이터, 설명, 비고
변수명	요청인자타입	샘플데이터	설명	비고
serviceKey	String	SERVICE_KEY	서비스 키
fcltyId	String	PF_0010069_01	농가 ID

출력항목
SAMPLE URL
SAMPLE DATA
결과메세지

출력항목

출력항목 - 항목, 항목인자타입, 샘플데이터, 항목명, 비고
항목	항목인자타입	샘플데이터	항목명	비고
fcltyId	String	PF_0010069_01	농가 ID
crpsnSn	Integer	2262	작기 일련번호
fcltyYear	String	2019	작기 관리 년도	형식 : yyyy
fixplntngDe	String	2019-09-10	작기 시작 일자	형식: yyyy-mm-dd
crpsnEndDe	String	2020-06-10	작기 종료 일자	형식: yyyy-mm-dd
ctvtAr	Integer	4958	재배 면적	단위 : ㎡
itemCode	String	080400	품목코드
itemCodeNm	String	딸기	품목명
spciesCode	String	4	품종코드
spciesCodeNm	String	금실	품종명

SAMPLE URL - 번호, 출력명, URL
번호	출력명	URL
2	작기 정보	http://www.smartfarmkorea.net/Agree_WS/webservices/DataMartItemRestService/getFcltyDateInfoDataList/{serviceKey}/{fcltyId}

SAMPLE DATA - 사용자 ID, 시설 ID, 지역명
농가 ID	작기 일련번호	작기 관리 년도	작기 시작 일자	작기 종료 일자	재배 면적	품목코드	품목명	품종코드	품종명
PF_0010069_01	2262	2019	2019-09-10	2020-06-10	4958	080400	딸기	null	null

Open API 요청인자

오퍼레이션 목록 - 변수명, 요청인자타입, 샘플데이터, 설명, 비고
변수명	요청인자타입	샘플데이터	설명	비고
serviceKey	String	SERVICE_KEY	서비스 키
fcltyId	String	PF_0010069_01	농가 ID
crpsnSn	Integer	2262	작기 일련번호
itemCode	String	080400	품목코드
fixplntngDe	String	20190910	조회 시작 일자	형식 : yyyymmdd
crpsnEndDe	String	20190910	조회 종료 일자	형식 : yyyymmdd

출력항목
SAMPLE URL
SAMPLE DATA
결과메세지

출력항목

출력항목 - 항목, 항목인자타입, 샘플데이터, 항목명, 비고
항목	항목인자타입	샘플데이터	항목명	비고
fcltyId	String	PF_0010069_01	농가 ID
crpsnSn	Integer	2262	작기 일련번호
itemCode	String	080400	품목코드
itemCodeNm	String	딸기	품목명
measDate	String	2019-09-10 00:00:00	측정 일시	형식 : yyyy-mm-dd hh:mm:ss
fatrCode	String	CI	항목코드
fatrCodeNm	String	내부CO2	항목명
senVal	Double	506.0	측정값

SAMPLE URL - 번호, 출력명, URL
번호	출력명	URL
3	환경 정보	http://www.smartfarmkorea.net/Agree_WS/webservices/DataMartItemRestService/getEnvInfoDataList/{serviceKey}/{fcltyId}/{crpsnSn}/{itemCode}/{fixPlntngDe}/{crpsnEndDe}

SAMPLE DATA - 사용자 ID, 시설 ID, 지역명
농가 ID	작기 일련번호	품목코드	품목명	측정 일시	항목코드	항목명	측정값
PF_0010069_01	2262	080400	딸기	2019-09-10 00:00:00	CI	내부CO2	506.0
PF_0010069_01	2262	080400	딸기	2019-09-10 00:00:00	HI	내부습도	93.0

Open API 요청인자

오퍼레이션 목록 - 변수명, 요청인자타입, 샘플데이터, 설명, 비고
변수명	요청인자타입	샘플데이터	설명	비고
serviceKey	String	SERVICE_KEY	서비스 키
fcltyId	String	PF_0010069_01	농가 ID
crpsnSn	Integer	2262	작기 일련번호
itemCode	String	080400	품목코드
fixplntngDe	String	20200113	조회 시작 일자	형식 : yyyymmdd
crpsnEndDe	String	20200113	조회 종료 일자	형식 : yyyymmdd

출력항목
SAMPLE URL
SAMPLE DATA
결과메세지

출력항목

출력항목 - 항목, 항목인자타입, 샘플데이터, 항목명, 비고
항목	항목인자타입	샘플데이터	항목명	비고
fcltyId	String	PF_0010069_01	농가 ID
crpsnSn	Integer	2262	작기 일련번호
itemCode	String	080400	품목코드
itemCodeNm	String	딸기	품목명
measDate	String	2020-01-13 11:00:00	측정 일시	형식 : yyyy-mm-dd hh:mm:ss
fatrCode	String	CC0403	항목코드
fatrCodeNm	String	차광커튼작동상태	항목명
senVal	Double	38.0	측정값

SAMPLE URL - 번호, 출력명, URL
번호	출력명	URL
4	제어 정보	http://www.smartfarmkorea.net/Agree_WS/webservices/DataMartItemRestService/getContInfoDataList/{serviceKey}/{fcltyId}/{crpsnSn}/{itemCode}/{fixPlntngDe}/{crpsnEndDe}

SAMPLE DATA - 사용자 ID, 시설 ID, 지역명
농가 ID	작기 일련번호	품목코드	품목명	측정 일시	항목코드	항목명	측정값
PF_0010069_01	2262	080400	딸기	2020-01-13 11:00:00	CC01_1_L_O	좌측일중천창 작동여부	0.0
PF_0010069_01	2262	080400	딸기	2020-01-13 11:00:00	CC0403	차광커튼작동상태	38.0

Open API 요청인자

오퍼레이션 목록 - 변수명, 요청인자타입, 샘플데이터, 설명, 비고
변수명	요청인자타입	샘플데이터	설명	비고
serviceKey	String	SERVICE_KEY	서비스 키
fcltyId	String	PF_0010069_01	농가 ID
crpsnSn	Integer	2262	작기 일련번호
fixplntngDe	String	20191209	조회 시작 일자	형식 : yyyymmdd
crpsnEndDe	String	20191209	조회 종료 일자	형식 : yyyymmdd

출력항목
SAMPLE URL
SAMPLE DATA
결과메세지

출력항목

출력항목 - 항목, 항목인자타입, 샘플데이터, 항목명, 비고
항목	항목인자타입	샘플데이터	항목명	비고
fcltyId	String	PF_0010069_01	농가 ID
crpsnSn	Integer	2262	작기 일련번호
grdvWeekT	Integer	13	생육 주차
examinMastrSn	String	21033	생육조사마스터 일련번호
examinDe	String	2019-12-09	조사 일자	형식 : yyyy-mm-dd
examinIemCode	String	10000001	항목코드
examinIemCodeNm	String	초장	항목명
examinIemValue	Double	268.0	측정값

SAMPLE URL - 번호, 출력명, URL
번호	출력명	URL
5	생육 정보	http://www.smartfarmkorea.net/Agree_WS/webservices/DataMartItemRestService/getExaminInfoDataList/{serviceKey}/{fcltyId}/{crpsnSn}/{fixPlntngDe}/{crpsnEndDe}

SAMPLE DATA - 사용자 ID, 시설 ID, 지역명
농가 ID	작기 일련번호	생육 주차	생육조사마스터 일련번호	조사 일자	항목코드	항목명	측정값
PF_0010069_01	2262	13	21033	2019-12-09	10000001	초장	268.0
PF_0010069_01	2262	13	21033	2019-12-09	10000003	엽수	8.0

Open API 요청인자

오퍼레이션 목록 - 변수명, 요청인자타입, 샘플데이터, 설명, 비고
변수명	요청인자타입	샘플데이터	설명
serviceKey	String	SERVICE_KEY	서비스 키
fcltyId	String	PF_0010069_01	농가 ID
crpsnSn	Integer	2262	작기 일련번호
examinMastrSn	Integer	29725	생육조사마스터 일련번호

출력항목
SAMPLE URL
SAMPLE DATA
결과메세지

출력항목

출력항목 - 항목, 항목인자타입, 샘플데이터, 항목명, 비고
항목	항목인자타입	샘플데이터	항목명
fcltyId	String	PF_0010069_01	농가 ID
crpsnSn	Integer	2262	작기 일련번호
grdvWeekT	Integer	32	생육 주차
examinMastrSn	Integer	29725	생육조사마스터 일련번호
spotImageSn	String	15567	이미지 순번
filePath	String	bchm/grdvexamin/spot/20200420/	파일 경로
fileNm	String	202004200948272090	파일명
orginlFileNm	String	현장.jpg	실제 파일명
fileExtsn	String	jpg	파일 확장자명
fileLink	String	https://bchm.smartfarmkorea.net/file/newGrdv/download.do?type=spot&flag=load&savePath=bchm/grdvexamin/spot/20200420/&fileName=202004200948272090&oriFileName=현장.jpg	파일 링크

SAMPLE URL - 번호, 출력명, URL
번호	출력명	URL
6	생육조사 표본사진 정보	http://www.smartfarmkorea.net/Agree_WS/webservices/DataMartItemRestService/getExaminSpotImgDataList/{serviceKey}/{fcltyId}/{crpsnSn}/{examinMastrSn}

SAMPLE DATA - 사용자 ID, 시설 ID, 지역명
농가 ID	작기 일련번호	생육 주차	생육조사마스터 일련번호	이미지 순번	파일 경로	파일명	실제 파일명	파일 확장자명	파일 링크
PF_0010069_01	2262	32	29725	15567	bchm/grdvexamin/spot/20200420/	202004200948272090	현장.jpg	jpg	https://bchm.smartfarmkorea.net/file/newGrdv/download.do?type=spot&flag=load&savePath=bchm/grdvexamin/spot/20200420/&fileName=202004200948272090&oriFileName=현장.jpg
PF_0010069_01	2262	32	29725	15568	bchm/grdvexamin/spot/20200420/	202004200948492330	1번.jpg	jpg	https://bchm.smartfarmkorea.net/file/newGrdv/download.do?type=spot&flag=load&savePath=bchm/grdvexamin/spot/20200420/&fileName=202004200948492330&oriFileName=1번.jpg

Open API 요청인자

오퍼레이션 목록 - 변수명, 요청인자타입, 샘플데이터, 설명, 비고
변수명	요청인자타입	샘플데이터	설명
serviceKey	String	SERVICE_KEY	서비스 키
fcltyId	String	PF_0010069_01	농가 ID
crpsnSn	Integer	2262	작기 일련번호
examinMastrSn	Integer	24692	생육조사마스터 일련번호

출력항목
SAMPLE URL
SAMPLE DATA
결과메세지

출력항목

출력항목 - 항목, 항목인자타입, 샘플데이터, 항목명, 비고
항목	항목인자타입	샘플데이터	항목명	비고
fcltyId	String	PF_0010069_01	농가 ID
crpsnSn	Integer	2262	작기 일련번호
examinMastrSn	Integer	24692	생육조사마스터 일련번호
iemClCode	String	C0007000000000000003	항목 분류 코드
iemClCodeNm	String	작물재배관리	항목 분류명
analsEndDe	String	20200216	분석 종료 일자	형식 : yyyymmdd
resultReprtSe	String	C0007	분석 구분 코드
resultReprtSeNm	String	컨설팅의견	분석 구분명
opinionCn	String	팁번 예방을 해줘야 하는 시기입니다.\n팁번은 칼슘이 잎 끝까지 전달되지 못해서 일어나는 생리장해입니다.\n일반적으로 밤에 근압을 적절히 발생시켜야…	의견 내용

SAMPLE URL - 번호, 출력명, URL
번호	출력명	URL
7	온라인 컨설팅 결과보고서 정보	http://www.smartfarmkorea.net/Agree_WS/webservices/DataMartItemRestService/getOnlineCnslResultDataList/{serviceKey}/{fcltyId}/{crpsnSn}/{examinMastrSn}

SAMPLE DATA - 사용자 ID, 시설 ID, 지역명
농가 ID	작기 일련번호	생육조사마스터 일련번호	항목 분류 코드	항목 분류명	분석 종료 일자	분석 구분 코드	분석 구분명	의견 내용
PF_0010069_01	2262	24692	C0007000000000000003	작물재배관리	20200216	C0007	컨설팅의견	팁번 예방을 해줘야 하는 시기입니다.\n팁번은 칼슘이 잎 끝까지…
PF_0010069_01	2262	24692	C0012000000000000001	외/내부 평균온도	20200216	C0012	분석의견	늘어난 광량이 충분히 유입되면서 주간온도가 크게 높아지는 시기입니다.…

Open API 요청인자

오퍼레이션 목록 - 변수명, 요청인자타입, 샘플데이터, 설명, 비고
변수명	요청인자타입	샘플데이터	설명	비고
serviceKey	String	SERVICE_KEY	서비스 키
fcltyId	String	PF_0010069_01	농가 ID
crpsnSn	Integer	2262	작기 일련번호
fixplntngDe	String	20210313	조회 시작 일자	형식 : yyyymmdd
crpsnEndDe	String	20210313	조회 종료 일자	형식 : yyyymmdd

출력항목
SAMPLE URL
SAMPLE DATA
결과메세지

출력항목

출력항목 - 항목, 항목인자타입, 샘플데이터, 항목명, 비고
항목	항목인자타입	샘플데이터	항목명	비고
fcltyId	String	PF_0010069_01	농가 ID
crpsnSn	Integer	2262	작기 일련번호
opShipDe	String	2021-03-13	조사 일자	형식 : yyyy-mm-dd
opAllShip	Integer	17	총 출하량	단위 : kg
opLvAa	Integer	0	등급_특상_출하량	단위 : kg
opLvA	Integer	17	등급_상_출하량	단위 : kg
opLvB	Integer	0	등급_중_출하량	단위 : kg
opLvC	Integer	0	등급_하_출하량	단위 : kg
opLvAaWon	Integer	0	등급_특상_단가	단위 : 원/kg
opLvAWon	Integer	2000	등급_상_단가	단위 : 원/kg
opLvBWon	Integer	0	등급_중_단가	단위 : 원/kg
opLvCWon	Integer	0	등급_하_단가	단위 : 원/kg
opIncome	Integer	34000	수입금	단위 : 원
opUnpsRate	Integer	0	비품과율	단위 : %
opShipPlc	String	동화청과(주)	출하처
opNote	String	없음	비고

SAMPLE URL - 번호, 출력명, URL
번호	출력명	URL
8	경영 정보(생산량)	http://www.smartfarmkorea.net/Agree_WS/webservices/DataMartItemRestService/getMngtOutputDataList/{serviceKey}/{fcltyId}/{crpsnSn}/{fixPlntngDe}/{crpsnEndDe}

SAMPLE DATA - 사용자 ID, 시설 ID, 지역명
농가 ID	작기 일련번호	조사 일자	총 출하량	등급_특상_출하량	등급_상_출하량	등급_중_출하량	등급_하_출하량	등급_특상_단가	등급_상_단가	등급_중_단가	등급_하_단가	수입금	비품과율	출하처	비고
PF_0010069_01	2262	2021-03-13	17	0	965	0	0	0	2000	0	0	34000	0	동화청과(주)	null

Open API 요청인자

오퍼레이션 목록 - 변수명, 요청인자타입, 샘플데이터, 설명, 비고
변수명	요청인자타입	샘플데이터	설명
serviceKey	String	SERVICE_KEY	서비스 키
fcltyId	String	PFS_0000001_01	농가 ID
crpsnSn	Integer	79	작기 일련번호
fixplntngDe	String	20150916	조회 시작 일자
crpsnEndDe	String	20150916	조회 종료 일자

출력항목
SAMPLE URL
SAMPLE DATA
결과메세지

출력항목

출력항목 - 항목, 항목인자타입, 샘플데이터, 항목명, 비고
항목	항목인자타입	샘플데이터	항목명	비고
fcltyId	String	PFS_0000001_01	농가 ID
crpsnSn	Integer	79	작기 일련번호
ctPayDe	String	2015-09-16	지출 일자	형식 : yyyy-mm-dd
ctOpcWkCost	Integer	256000	경영비_총 구매 비용	단위 : 원
ctFmwWkTime	Integer	1	영농작업_총 작업시간	단위 : 시간
fmwWkCost	Integer	1000000	영농작업_총 작업 비용	단위 : 원
ctFmwWkPpl	Integer	5	영농작업_총 작업 인력	단위 : 명

SAMPLE URL - 번호, 출력명, URL
번호	출력명	URL
9	경영 정보(생산비)	http://www.smartfarmkorea.net/Agree_WS/webservices/DataMartItemRestService/getMngtCostDataList/{serviceKey}/{fcltyId}/{crpsnSn}/{fixPlntngDe}/{crpsnEndDe}

SAMPLE DATA - 사용자 ID, 시설 ID, 지역명
농가 ID	작기 일련번호	지출 일자	경영비_총 구매 비용	영농작업_총 작업 시간	영농작업_총 작업 비용	영농작업_총 작업 인력
PFS_0000001_01	79	2015-09-16	268289	0	0	0

■ 수집되는 개인정보 항목
- 농림수산식품교육문화정보원 스마트팜 Open API 서비스 이용을 위해 아래와 같은 개인정보를 수집하고 있습니다.
- ○ 수집항목 : 이름, 핸드폰, E-Mail, 업체(기관)명, 부서, 직급(직위), 사업(연구명), 추진기간
- ,주무부처기관명, 예산, API 사용목적, 필요정보, 활동내용, 도출시기, API 신청패스워드
- ○ 개인정보 수집방법 : 스마트팜 홈페이지(Open API 이용신청)
■ 개인정보의 수집 및 이용목적
- 농림수산식품교육문화정보원 스마트팜 Open API 서비스 이용을 위해 아래와 같은 개인정보를 수집하고 있습니다.
- ○ Open API 신청 관리
- Open API 신청에 따른 인증키 발급에 따라 인증키 발급내역을 관리하기 위해 본인확인, API인증키 내역 확인
■ 개인정보의 보유 및 이용기간
- 원칙적으로, 개인정보 수집 및 이용목적이 달성된 후에는 해당 정보를 지체 없이 파기합니다, 단, 관계법령의 규정에
- 의하여 보존할 필요가 있는 경우 아래와 같이 관계법령에서 정한 일정한 기간 동안 개인정보를 보관합니다.
- - 보존 항목 : 업체(기관)명, 예산, API 사용목적, 부서, 직급(직위), 사용자연락처, 사용자Email, 사업(연구)명, 추진기간
- , 주무부처.기관, 예산, API 사용목적, 필요정보, 활용내용, 도출시기, API신청일자, API 신청 패스워드
- - 보존 근거 : 정보통신망 이용촉진 및 정보보호 등에 관한 법률
- - 보존 기간 : 본인인증 후 API신청 ~ API 삭제시 까지

신청접수 된 결과를 조회 할 수 있습니다.

OPEN API 신청확인
사용자 명	사용자 명
API 신청 패스워드	패스워드 변경
API key
API 승인여부

오픈API 신청확인 더보기
업체(기관)명
부서		직급(직위)
사용자 연락처		사용자 Email
사업(연구)명		추진기간
주무부처.기관		예산
API사용목적
필요정보
활용내용
도출시기		API신청일자

검색기간	~

한우 낙농 양돈 양계

축종	파일명	다운로드
한우	EPD 정보 데이터	다운로드
한우	등급판정정보	다운로드

신청접수 된 결과를 조회 할 수 있습니다.

추가정보입력
사용자 이름	사용자이름
비밀번호	비밀번호
신청 서비스	서비스 구분

※ 비밀번호 분실시 스마트 팜 콜센터 1522-2911 연락바랍니다

API 신청 패스워드 변경
기존 패스워드	기존 패스워드
새 패스워드	새 비밀번호
새 패스워드 확인	새 비밀번호 확인

품목별 데이터셋 제공서비스

데이터 마트

Open API 메타정보

오퍼레이션 목록

Open API 요청인자

출력항목

SAMPLE URL

SAMPLE 결과

SAMPLE DATA

결과메시지

Open API 요청인자

출력항목

SAMPLE URL

SAMPLE 결과

SAMPLE DATA

결과메시지

Open API 요청인자

출력항목

SAMPLE URL

SAMPLE 결과

SAMPLE DATA

결과메시지

Open API 요청인자

출력항목

SAMPLE URL

SAMPLE 결과

SAMPLE DATA

결과메시지

Open API 요청인자

출력항목

SAMPLE URL

SAMPLE 결과

SAMPLE DATA

결과메시지

Open API 요청인자

출력항목

SAMPLE URL

SAMPLE 결과

SAMPLE DATA

결과메시지

Open API 요청인자

출력항목

SAMPLE URL

SAMPLE 결과

SAMPLE DATA

결과메시지

Open API 요청인자

출력항목

SAMPLE URL

SAMPLE 결과

SAMPLE DATA

결과메시지

Open API 요청인자

출력항목

SAMPLE URL

SAMPLE 결과

SAMPLE DATA

결과메시지

관련사이트