KCCI | 위해상품 판매차단 시스템

API 연계란?

정부검사기관에서 제공한 위해상품 정보를 API를 통해 유통업체에 제공합니다.

참여안내

목적

위해상품 정보를 실시간 연계하여 매장 POS에서 즉시 차단
범위

위해상품 정보 조회 및 차단 알림 전송, 상태 확인 등
방식

REST API(HTTPS) 제공 본사 시스템 및 POS 연동 지원

참여절차

API 신청
심사
API 서비스 인증키 발급
유통사 내부시스템 개발
운영

신청서 작성시 주의사항

신청업체 POS 업체 여부

체인유통매장일 경우 '아니오'
단독유통매장일 경우 '예'
업무(신청)담당자 이메일

신청 후, 승인 및 반려 정보를 발송하므로 올바르게 작성
수신기관

위해상품 정보를 수신할 정부검사기관 선택
개인정보 수집 및 이용 동의 필수

미동의 시 신청 불가

신청 및 가이드

사용 예제

import java.io.BufferedReader;
import java.io.DataOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.UnsupportedEncodingException;
import java.net.HttpURLConnection;
import java.net.MalformedURLException;
import java.net.URL;
import java.net.URLEncoder;
import java.util.HashMap;
import java.util.Map;

public class ApiSample {

public static void main(String[] args) {

// API 가이드(체인유통매장용) 위해상품 통보 정보에 필요한 코드 정보 불러오기 예시입니다.

String apiURL = "https://upss.gs1kr.org/api/v1/code";  // 요청 URL

String serviceCrtfcKey = "40a17174fb3343b6a1b942b6dc85c419"; // API 신청으로 발급받은 서비스 인증 키

Map<String, String> requestHeaders = new HashMap<>(); // Reqeust Header Data 부분

requestHeaders.put("serviceCrtfcKey", serviceCrtfcKey);

Map<String, String> requestBodies = new HashMap<>(); // Reqeust Body Data 부분

//requestBodies.put("reqDocDt", "20211122000000");

String responseBody = post(apiURL, requestHeaders, requestBodies);

System.out.println(responseBody);
    }

private static String post(String apiUrl, Map<String, String> requestHeaders, Map<String, String> requestBodies){
        HttpURLConnection con = connect(apiUrl);
        try {
            con.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");

con.setRequestMethod("POST");

con.setDoOutput(true);

for(Map.Entry<String, String> header :requestHeaders.entrySet()) {
                con.setRequestProperty(header.getKey(), header.getValue());
            }

DataOutputStream dataOutputstr = new DataOutputStream(con.getOutputStream());
            dataOutputstr.writeBytes(getDataString(requestBodies));
            dataOutputstr.flush();
            dataOutputstr.close();

int responseCode = con.getResponseCode();
            if (responseCode == HttpURLConnection.HTTP_OK) { // 정상 호출
                return readBody(con.getInputStream());
            } else { // 에러 발생
                return readBody(con.getErrorStream());
            }
        } catch (IOException e) {
            throw new RuntimeException("API 요청과 응답 실패", e);
        } finally {
            con.disconnect();
        }
    }

private static String getDataString(Map<String, String> params) {
        StringBuilder result = new StringBuilder();
        boolean first = true;
        for(Map.Entry<String, String> entry : params.entrySet()){
            if(first) {
            	first = false;
            } else {
            	result.append("&");
            }

try {
                result.append(URLEncoder.encode(entry.getKey(), "UTF-8"));
                result.append("=");
                result.append(URLEncoder.encode(entry.getValue(), "UTF-8"));
            } catch (UnsupportedEncodingException e) {
                throw new RuntimeException("인코딩이 실패했습니다. : ", e);
            }

}
        return result.toString();
    }

private static HttpURLConnection connect(String apiUrl){
        try {
            URL url = new URL(apiUrl);
            return (HttpURLConnection)url.openConnection();
        } catch (MalformedURLException e) {
            throw new RuntimeException("API URL이 잘못되었습니다. : " + apiUrl, e);
        } catch (IOException e) {
            throw new RuntimeException("연결이 실패했습니다. : " + apiUrl, e);
        }
    }

private static String readBody(InputStream body){
        InputStreamReader streamReader = new InputStreamReader(body);

try (BufferedReader lineReader = new BufferedReader(streamReader)) {
            StringBuilder responseBody = new StringBuilder();

String line;
            while ((line = lineReader.readLine()) != null) {
                responseBody.append(line);
            }

return responseBody.toString();
        } catch (IOException e) {
            throw new RuntimeException("API 응답을 읽는데 실패했습니다.", e);
        }
    }
}

참여문의

담당부서 대한상공회의소 유통물류진흥원
TEL 02-6050-1481
email chani@korcham.net

수신기관

유통사

유통사 계정은 현재 위해상품 판매차단 운영매장에 등록 및 시스템을 운영하고 있는 유통사의 담당자 계정입니다.

정부 검사기관

국가기술표준원, 식품의약품안전처, 환경부의 위해상품통보 담당자 계정입니다. 국가기술표준원을 제외한 식품의약품안전처와 기후에너지환경부는 검사 상품군 담당부서별 계정이 개별적으로 부여되어 있사오니 참고하시기 바랍니다.

위해상품판매차단시스템

위해상품판매차단시스템

API 연계

API 연계란?

참여안내

목적

범위

방식

참여절차

신청서 작성시 주의사항

신청 및 가이드

사용 예제

참여문의

API 연계

API 연계란?

참여안내

목적

범위

방식

참여절차

신청서 작성시 주의사항

신청 및 가이드

사용 예제

참여문의

API 신청

신청업체

업무(신청) 담당자

수신기관

이용을 위해 로그인이 필요합니다

아이디찾기

비밀번호 찾기

권한별 로그인 가이드

유통사

정부 검사기관