홈

메타정보
서비스 서비스명 서비스유형
최종수정일 업데이트주기 -
최초개방일 API호출제한
제공기관 기관 분류
설명 속성정보
비고 -
서비스 샘플이 없습니다.
OpenAPI 이용신청

요청주소

요청주소
요청주소 URL 형식 http://openapi.foodsafetykorea.go.kr/api/keyId/serviceId/dataType/startIdx/endIdx
샘플 http://openapi.foodsafetykorea.go.kr/api/sample//xml/1/5
파일 http://openapi.foodsafetykorea.go.kr/api/인증키//file
URL설명 요청인자가 없을 경우 http://openapi.foodsafetykorea.go.kr/api/인증키/서비스명/요청파일타입/요청시작위치/요청종료위치
요청인자가 있을 경우 http://openapi.foodsafetykorea.go.kr/api/인증키/서비스명/요청파일타입/요청시작위치/요청종료위치/변수명=값&변수명=값2

요청인자

요청인자
번호 변수명 타입 변수설명 값설명
1 keyId STRING(필수) 인증키 OpenAPI 에서 발급된 인증키
2 serviceId STRING(필수) 서비스명 요청대상인 해당 서비스명
3 dataType STRING(필수) 요청파일 타입 xml : xml파일 , json : json파일
4 startIdx STRING(필수) 요청시작위치 정수입력
5 endIdx STRING(필수) 요청종료위치 정수입력
변수 목록
번호 항목 설명
번호 메세지코드 메세지설명
1 INFO-000 정상 처리되었습니다.
2 INFO-100 인증키가 유효하지 않습니다. 인증키가 없는 경우, 홈페이지에서 인증키를 신청하십시오.
3 INFO-110 인증키는 확인되었으나 해당 서비스의 활용신청 내역이 없습니다. 홈페이지에서 활용신청 후 이용하십시오.
4 INFO-120 서비스 신청상태가 유효하지 않습니다. 홈페이지에서 서비스신청상태를 확인해주세요.
5 INFO-200 해당하는 데이터가 없습니다.
6 INFO-300 유효 호출건수를 이미 초과하셨습니다.
7 INFO-310 샘플키로 더 이상 호출할 수 없습니다. 이용신청을 해주십시오.
8 INFO-320 증분 파라미터를 사용하지 않으면 1시간당 100회까지만 호출할 수 있습니다.
9 INFO-330 파일 다운로드는 인증키당 서비스별로 1일 10회까지 가능합니다.
10 INFO-400 권한이 없습니다. 관리자에게 문의하십시오.
11 INFO-500 현재 접속 중인 인증키입니다. 잠시 후에 다시 시도하십시오.
12 INFO-600 인증키가 만료되었습니다.
13 INFO-700 오늘날짜에 생성 및 변경된 데이터는 19시 이후에 호출이 가능합니다.
14 ERROR-300 필수 값이 누락되어 있습니다. 요청인자를 참고 하십시오.
15 ERROR-301 파일타입 값이 누락 혹은 유효하지 않습니다. 요청인자 중 TYPE을 확인하십시오.
16 ERROR-302 요청인자의 값 형식이 올바르지 않습니다. 날짜조건은 YYYYMMDD 8자리 단일값으로 입력하십시오.
17 ERROR-303 호출일자 기준 최대 7일까지 증분 데이터만 호출할 수 있습니다.
18 ERROR-310 해당하는 서비스를 찾을 수 없습니다. 요청인자 중 SERVICE를 확인하십시오.
19 ERROR-331 요청시작위치 값을 확인하십시오. 요청인자 중 START_INDEX를 확인하십시오.
20 ERROR-332 요청종료위치 값을 확인하십시오. 요청인자 중 END_INDEX를 확인하십시오.
21 ERROR-334 종료위치보다 시작위치가 더 큽니다. 요청시작조회건수는 정수를 입력하세요.
22 ERROR-336 데이터요청은 한번에 최대 1000건을 넘을 수 없습니다.
23 ERROR-500 서버오류입니다.
24 ERROR-503 06시~19시에는 인증키/서비스별 300회까지만 호출할 수 있습니다. 이용에 참고바랍니다.
25 ERROR-601 SQL 문장 오류입니다.
OpenAPI 이용신청

요청주소

요청주소
요청주소 URL 형식 http://openapi.foodsafetykorea.go.kr/api/keyId/serviceId/dataType/startIdx/endIdx
샘플 http://openapi.foodsafetykorea.go.kr/api/sample//xml/1/5
파일 http://openapi.foodsafetykorea.go.kr/api/인증키//file
URL설명 요청인자가 없을 경우 http://openapi.foodsafetykorea.go.kr/api/인증키/서비스명/요청파일타입/요청시작위치/요청종료위치
요청인자가 있을 경우 http://openapi.foodsafetykorea.go.kr/api/인증키/서비스명/요청파일타입/요청시작위치/요청종료위치/변수명=값&변수명=값2

요청인자

요청인자
번호 변수명 타입 변수설명 값설명
1 keyId STRING(필수) 인증키 OpenAPI 에서 발급된 인증키
2 serviceId STRING(필수) 서비스명 요청대상인 해당 서비스명
3 dataType STRING(필수) 요청파일 타입 xml : xml파일 , json : json파일
4 startIdx STRING(필수) 요청시작위치 정수입력
5 endIdx STRING(필수) 요청종료위치 정수입력
변수 목록
번호 항목 설명
번호 메세지코드 메세지설명
1 INFO-000 정상 처리되었습니다.
2 INFO-100 인증키가 유효하지 않습니다. 인증키가 없는 경우, 홈페이지에서 인증키를 신청하십시오.
3 INFO-110 인증키는 확인되었으나 해당 서비스의 활용신청 내역이 없습니다. 홈페이지에서 활용신청 후 이용하십시오.
4 INFO-120 서비스 신청상태가 유효하지 않습니다. 홈페이지에서 서비스신청상태를 확인해주세요.
5 INFO-200 해당하는 데이터가 없습니다.
6 INFO-300 유효 호출건수를 이미 초과하셨습니다.
7 INFO-310 샘플키로 더 이상 호출할 수 없습니다. 이용신청을 해주십시오.
8 INFO-320 증분 파라미터를 사용하지 않으면 1시간당 100회까지만 호출할 수 있습니다.
9 INFO-330 파일 다운로드는 인증키당 서비스별로 1일 10회까지 가능합니다.
10 INFO-400 권한이 없습니다. 관리자에게 문의하십시오.
11 INFO-500 현재 접속 중인 인증키입니다. 잠시 후에 다시 시도하십시오.
12 INFO-600 인증키가 만료되었습니다.
13 INFO-700 오늘날짜에 생성 및 변경된 데이터는 19시 이후에 호출이 가능합니다.
14 ERROR-300 필수 값이 누락되어 있습니다. 요청인자를 참고 하십시오.
15 ERROR-301 파일타입 값이 누락 혹은 유효하지 않습니다. 요청인자 중 TYPE을 확인하십시오.
16 ERROR-302 요청인자의 값 형식이 올바르지 않습니다. 날짜조건은 YYYYMMDD 8자리 단일값으로 입력하십시오.
17 ERROR-303 호출일자 기준 최대 7일까지 증분 데이터만 호출할 수 있습니다.
18 ERROR-310 해당하는 서비스를 찾을 수 없습니다. 요청인자 중 SERVICE를 확인하십시오.
19 ERROR-331 요청시작위치 값을 확인하십시오. 요청인자 중 START_INDEX를 확인하십시오.
20 ERROR-332 요청종료위치 값을 확인하십시오. 요청인자 중 END_INDEX를 확인하십시오.
21 ERROR-334 종료위치보다 시작위치가 더 큽니다. 요청시작조회건수는 정수를 입력하세요.
22 ERROR-336 데이터요청은 한번에 최대 1000건을 넘을 수 없습니다.
23 ERROR-500 서버오류입니다.
24 ERROR-503 06시~19시에는 인증키/서비스별 300회까지만 호출할 수 있습니다. 이용에 참고바랍니다.
25 ERROR-601 SQL 문장 오류입니다.
목록