Open API 인터페이스 설계서

국가기술표준원 SafetyKorea

서비스 제공용

Version 1.7

2020-06-08

국가기술표준원 SafetyKorea에서는

KC인증정보

국내리콜정보

국외리콜정보

데이터를 활용할 수 있도록

Open API로 제공하고 있습니다.

제·개정 이력

버전	변경일자	제·개정 내용	작성자
1.1	2015-03-01	-	-
1.2	2016-02-03	-	-
1.3	2018-07-14	항목설명 수정 (공산품→생활용품)	정승옥
1.4	2019-07-16	KC인증정보: 인증리스트 API signDate (등록일) 항목 추가	정승옥
1.5	2019-10-24	KC인증정보: 인증리스트 API remark (상세내용) 항목 추가	정승옥
1.6	2020-04-20	국외리콜정보: API 추가	정승옥
1.7	2020-06-08	국외리콜정보 fRecallUid 검색조건 추가	정승옥

목차

인터페이스 방식	1

API 방식	2

서비스 ID 발급 및 활용	2

KC인증정보 서비스	3

제공 서비스 목록	3

KC인증정보 조회	3

KC인증정보 상세 조회	5

국내·국외 리콜정보 서비스	8

제공 서비스 목록	8

국내리콜정보 조회	8

국내리콜정보 상세 조회	11

국외리콜정보 조회	13

URL 링크	17

개요	17

제공 URL 명세	17

코드	18

개요	18

결과 코드 명세	18

1. 인터페이스 방식

순번	방식	설명
1	API 방식	Restful 방식으로 제공하며, JSON, XML 형태의 결과물을 제공합니다.
2	URL 링크	기존에 제공하던 제품 인증정보 상세조회 팝업 URL을 제공합니다.

2. API 방식

2.1. 서비스 ID 발급 및 활용

◇ 국가기술표준원 제품안전정보센터에서 서비스 ID를 별도로 발급하여 제공합니다.

◇ 서비스를 사용하고자 할 때는 발급받은 서비스 ID를 HTTP Header 에 삽입하여 Http Request로 요청합니다.

◇ HTTP Header에 key는 AuthKey이며, value는 각 safetykorea에서 발급한 서비스 ID를 SET 합니다.

◇ 대소문자는 구분해야 합니다.

◇ 모든 조회목록은 최대 1,000 줄까지만 제공됩니다.

◇ API URL 확장자에 따라 결과를 json 이나 xml 로 받을 수 있습니다. (예제는 json 입니다.)

◇ Http Response 결과 메시지 기본 명세

항목명(영문)	항목명(국문)	항목구분	항목설명
resultCode	결과코드	필수	별도 정의
resultMsg	결과메세지	필수	별도 정의
resultData	결과데이터	선택	요청할 실제 데이터가 존재

3. KC인증정보 서비스

3.1. 제공 서비스 목록

	제공 서비스	항목설명
1	KC인증정보 조회	전체조회, 인증번호, 제품명, 모델명(로트번호), 상표명, 인증일자
2	KC인증정보 상세 조회

3.2. KC인증정보 조회

◇ 요청 메시지 URL

HTTP MEthod	GET
HTTP URL	http://www.safetykorea.kr/openapi/api/cert/certificationList.json?conditionKey={검색구분}&conditionValue={검색어}

◇ 요청 메시지 명세

항목명(영문)	항목명(국문)	항목구분	항목설명
conditionKey	검색구분	필수	all : 전체 certNum : 인증번호 productName : 제품명 modelName ; 모델명 certDate : 인증일자 signDate : 등록일
conditionValue	검색어	필수

◇ 응답 메시지 형태

JSON

{

"resultCode": "2000",

"resultMsg": "Success",

"resultData": [

{

"certUid": 1231231

"certOrganName": "한국건설생활시험연구원(KCL)",

"certNum": "CB123A123-1234",

"certState": "적합",

"certDiv": "어린이제품 특별법 대상>안전확인 대상",

"certDate": "20190717",

"certChgDate": null,

"certChgReason": null,

"firstCertNum": "CB123A123-1234",

"productName": "유아용섬유제품",

"brandName": null,

"modelName": "아동배낭",

"categoryName": null,

"importDiv": "제조",

"makerName": "아이테스트",

"makerCntryName": "한국",

"importerName": "아이테스트",

"remark": null,

"signDate": "20190717",

},

{

"certUid": 1231232,

"certOrganName": "한국의류시험연구원(KATRI)",

"certNum": "CB123A123-1232",

"certState": "적합",

"certDiv": "어린이제품 특별법 대상>안전확인 대상",

"certDate": "20190717",

"certChgDate": null

"certChgReason": “변경사유”

"firstCertNum": "CB123A123-1232",

"productName": "유아용 테스트",

"brandName": 브랜드명,

"modelName": "방수테스트",

"categoryName": "유아용 섬유제품>신생아용품>기저귀매트",

"importDiv": "제조",

"makerName": "어테스트",

"makerCntryName": "한국",

"importerName": 수입사,

"remark": “제품상세내용”,

"signDate": "20190717",

}

◇ 응답 메시지 명세

항목명(영문)	항목명(국문)	항목설명
certUid	인증정보 아이디
certNum	인증번호(필증번호)
certState	인증상태	안전인증취소, 개선명령, 안전인증표시 사용금지 2개월, 안전인증표시 사용금지 4개월, 안전확인신고 효력상실, 안전확인신고표시 사용금지 2개월, 적합, 반납, 청문실시, 기간만료
certDate	인증일자
certDiv	인증구분	전안법/어린이법의 안전인증, 안전확인 대상
productName	제품명
brandName	브랜드명
modelName	모델명(로트번호)
categoryName	법정 제품분류명
importDiv	수입/제조 구분	수입, 제조
makerName	제조사명
makerCntryName	제조국 명
importerName	수입사 명
firstCertNum	최초인증번호
signDate	등록일
remark	상세내용	제품 상세내용

3.2.1. KC인증정보 상세 조회

◇ 요청 메시지 URL

HTTP Method	GET
HTTP URL	http://www.safetykorea.kr/openapi/api/cert/certificationDetail.json?certNum={인증번호}

◇ 요청 메시지 명세

항목명(영문)	항목명(국문)	항목구분	항목설명
certNum	인증번호	필수

◇ 응답 메시지 형태

JSON

{

"resultMsg": "Success.",

"resultCode": 2000,

"resultData": {

"certUid": 3512259,

"certOrganName": "한국화학융합시험연구원(KTR)",

"certNum": "JU071047-12002C",

"certState": "적합",

"certDiv": "전기용품안전관리법 대상>자율안전확인 대상",

"certDate": "20130719",

"certChgDate": null,

"certChgReason": null,

"firstCertNum": "JU071047-12002",

"productName": "관상어용히터",

"brandName": null,

"modelName": "SH-100",

"categoryName": "전기기기>관상 및 애완용 전기기기>관상어용·식물용 히터",

"importDiv": "수입",

"makerName": "Zhong Shan City Sanhu Aquarium Goods Factory",

"makerCntryName": "중국",

"importerName": "Zhong Shan City Sanhu Aquarium Goods Factory",

"remark": null,

"signDate": "20181227",

"derivationModels": [ 0: “modelName1", 1: "modelName2"],

"certificationImageUrls": [

"http://office.safetykorea.kr/fileData/certInfo/2014/07/B364R1086-4004_1.jpg",

"http://office.safetykorea.kr/fileData/certInfo/2014/07/B364R1086-4004_2.jpg",

"http://office.safetykorea.kr/fileData/certInfo/2014/07/B364R1086-4004_3.jpg",

"http://office.safetykorea.kr/fileData/certInfo/2014/07/B364R1086-4004_4.jpg",

"http://office.safetykorea.kr/fileData/certInfo/2014/07/B364R1086-4004_5.jpg"

],

"factories": [

{"makerName": "RalotIndustriesLtd."}

],

"similarCertifications": [

-0 :{

"certUid": 3511824,

"certOrganName": "한국화학융합시험연구원(KTR)",

"certNum": "JU071047-12002",

"certState": "적합",

"certDiv": "전기용품안전관리법 대상>안전인증 대상",

"certDate": "20120802",

"certChgDate": null,

"certChgReason": null,

"firstCertNum": "JU071047-12002",

"productName": "관상어용히터",

"brandName": null,

"modelName": "SH-100",

"categoryName": "전기기기>관상 및 애완용 전기기기>관상어용·식물용 히터",

"importDiv": "수입",

"makerName": "Zhong Shan City Hailang Electrical Factory ",

"makerCntryName": "중국",

"importerName": "(주)삼호무역",

"remark": null,

"signDate": "20181227"

},

-1:{

"certUid": 3512248,

"certOrganName": "한국화학융합시험연구원(KTR)",

"certNum": "JU071047-12002A",

"certState": "적합",

"certDiv": "전기용품안전관리법 대상>안전인증 대상",

"certDate": "20120809",

"certChgDate": null,

"certChgReason": null,

"firstCertNum": "JU071047-12002",

"productName": "관상어용히터",

"brandName": null,

"modelName": "SH-100",

"categoryName": "전기기기>관상 및 애완용 전기기기>관상어용·식물용 히터",

"importDiv": "수입",

"makerName": "Zhong Shan City Hailang Electrical Factory ",

"makerCntryName": "중국",

"importerName": "(주)삼호무역",

"remark": null,

"signDate": "20181227"

}

]}}

◇ 응답 메시지 명세

항목명(영문)	항목명(국문)	항목설명
certNum	인증번호(필증번호)
certState	인증상태	안전인증취소, 개선명령, 안전인증표시 사용금지 2개월, 안전인증표시 사용금지 4개월, 안전확인신고 효력상실, 안전확인신고표시 사용금지 2개월, 적합, 반납, 청문실시, 기간만료
certDate	인증일자
certDiv	인증구분	전안법/어린이법의 안전인증, 안전확인 대상
productName	제품명
brandName	브랜드명
modelName	모델명(로트번호)
derivationModels	파생모델 목록	파생모델명을 배열로 제공
categoryName	법정 제품분류명
importDiv	수입/제조 구분	수입,제조
makerName	제조사 명
makerCntryName	제조국 명
importerName	수입사 명
firstCertNum	최초인증번호
similarCertifications	연관 인증번호 목록	최초인증번호로 조회되는 인증번호 배열 목록 (json 형태는 인증번호 조회 목록과 같음)
factories	제조공장 목록	제조공장 정보를 json배열로 제공
certificationImageUrls	인증 이미지 URL 목록	인증이미지의 이미지 URL을 배열로 제공
remark	상세내용	제품상세내용

◇ 복수 제조공장

항목명(영문)	항목명(국문)	항목설명
makerName	제조사 명
makerCntryName	제조국 명

4. 국내·국외 리콜정보 서비스

4.1. 제공 서비스 목록

	제공 서비스	항목설명
1	국내리콜정보 조회	전체조회, 바코드, 제품명, 상표명, 모델명, 인증번호, 공표일자
2	국내리콜정보 상세 조회	리콜아이디
3	국외리콜정보 조회	제품명, 브랜드명, 모델명, 공표일자

4.2. 국내리콜정보 조회

◇ 요청 메시지 URL

HTTP Method	GET
HTTP URL	http://www.safetykorea.kr/openapi/api/recall/recallList.json?conditionKey={검색구분}&conditionValue={검색어}

◇ 요청 메시지 명세

항목명(영문)	항목명(국문)	항목구분	항목설명
conditionKey	검색구분	필수	all : 전체 barcodeNum : 바코드 recallProductName : 제품명 recallBrandName : 상표명 recallModelName : 모델명 certNum : 인증번호 publishDate : 공표일자
conditionValue	검색어	필수

◇ 응답 메시지 형태

JSON

{

"resultCode": "2000",

"resultMsg": "Success",

"resultData": [

{

"recallUid": "3802",

"recallProductName": "가정용섬유제품(책가방)",

"recallBrandName": "JJ",

"recallModelName": "HKAK31101S-00",

"recallModelCnt": 0,

"recallTypeName": "명령에따른리콜",

"recallMeans": null,

"barcodeNum": null,

"categoryName": null,

"certNum": "공급자적합성",

"productItemName": null,

"recallCmpnyDivName": "수입",

"recallInqryTel": "080-023-0456",

"recallCmpnyName": "(주)이랜드월드패션사업부",

"recallCmpnySsn": null,

"recallFrgnCmpnyName": null,

"makerCntryName": null,

"makerName": "㈜이랜드월드패션사업부",

"makingCntryName": "국외>아시아지역>중국",

"publishDate": "20130418",

"publishRecallVol": null,

"recallActionAmt": null,

"recallStaDate": null,

"recallEndDate": null,

"harmDscr": null,

"accidentCaseDscr": null,

"recallFiles": null

},

{

"recallUid": "3737",

"recallProductName": "가정용섬유제품(책가방)",

"recallBrandName": "우고가방",

"recallModelName": "T3S-T-1-503",

"recallModelCnt": 0,

"recallTypeName": "명령에따른리콜",

"recallMeans": null,

"barcodeNum": null,

"categoryName": null,

"certNum": "공급자적합성",

"productItemName": null,

"recallCmpnyDivName": "수입",

"recallInqryTel": "02-929-5622",

"recallCmpnyName": "참존어패럴",

"recallCmpnySsn": null,

"recallFrgnCmpnyName": null,

"makerCntryName": null,

"makerName": "우고가방",

"makingCntryName": "국외>아시아지역>중국",

"publishDate": "20130418",

"publishRecallVol": null,

"recallActionAmt": null,

"recallStaDate": null,

"recallEndDate": null,

"harmDscr": null,

"accidentCaseDscr": null,

"recallFiles": null

}

],

}

◇ 응답 메시지 명세

항목명(영문)	항목명(국문)	항목설명
recallUid	리콜 아이디
recallProductName	제품명
recallBrandName	브랜드명
recallModelName	모델명	리콜 모델 목록 ( 콤마(,) 구분 )
recallModelCnt	리콜 모델 개수
recallTypeName	리콜종류
recallMeans	리콜방법
barcodeNum	바코드
categoryName	제품분류명
certNum	인증번호	인증번호 목록 ( 콤마 (,) 구분 )
productItemName	제품 품목명
recallCmpnDivName	리콜 사업자 구분	수입, 제조, 판매, 리콜대행
recallInqryTel	리콜 문의전화
recallCmpnyName	리콜 사업자명
recallCmpnySsn	리콜 사업자번호
recallFrgnCmpnyName	해외사업자 명	리콜대행인 경우 사용
makerCntryName	제조사 국가명	제조 공장 국가
makerName	제조사 명
makingCntryName	제조 국가명	제조 공장 국가
publishDate	공표일	yyyyMMdd 형태
publishRecallVol	리콜 범위	공표문 상의 리콜 수량
recallActionAmt	리콜 조치 수량
recallStaDate	리콜 시작일자
recallEndDate	리콜 종료일자
harmDscr	위해 내용
accidentCaseDscr	사고 사례

4.2.1. 국내리콜정보 상세 조회

◇ 요청 메시지 URL

HTTP Method	GET
HTTP URL	http://www.safetykorea.kr/openapi/api/recall/recallDetail.json?recallUid={리콜아이디}

◇ 요청 메시지 명세

항목명(영문)	항목명(국문)	항목구분	항목설명
recallUid	검색어	필수

◇ 응답 메시지 형태

JSON

{

"resultCode": "2000",

"resultMsg": "성공",

"resultData": {

"recallUid": "2799",

"recallProductName": "완구",

"recallBrandName": null,

"recallModelName": "수호달걀",

"recallModelCnt": 1,

"recallTypeName": "명령에따른리콜",

"recallMeans": null,

"barcodeNum": null,

"categoryName": null,

"certNum": null,

"productItemName": "어린이용품>완구",

"recallCmpnyDivName": null,

"recallInqryTel": null,

"recallCmpnyName": "(주)주영조이",

"recallCmpnySsn": "206-86-39150",

"recallFrgnCmpnyName": null,

"makerCntryName": "국내>아시아지역>대한민국",

"makerName": "(주)주영조이",

"makingCntryName": "국내>아시아지역>대한민국",

"publishDate": "20121228",

"publishRecallVol": null,

"recallActionAmt": null,

"recallStaDate": null,

"recallEndDate": null,

"harmDscr": null,

"accidentCaseDscr": "없음",

"recallFiles": [

{

"fileDiv": "전체사진",

"imageUrl": "http://office.safetykorea.kr/fileData/recall/0000/00/2908/pharos_2908.jpg"

},

{

"fileDiv": "부분사진",

"imageUrl": "http://office.safetykorea.kr/fileData/recall/2020/03/1584596218648_2799_2_0.png"

}

],

}

}

◇ 응답 메시지 명세

항목명(영문)	항목명(국문)	항목설명
recallUid	리콜 아이디
recallProductName	제품명
recallBrandName	브랜드명
recallModelName	모델명	리콜 모델 목록 ( 콤마(,) 구분 )
recallModelCnt	리콜 모델 개수
recallTypeName	리콜종류
recallMeans	리콜방법
barcodeNum	바코드
categoryName	제품분류명
certNum	인증번호	인증번호 목록 ( 콤마 (,) 구분 )
productItemName	제품 품목명
recallCmpnDivName	리콜 사업자 구분	수입, 제조, 판매, 리콜대행
recallInqryTel	리콜 문의전화
recallCmpnyName	리콜 사업자명
recallCmpnySsn	리콜 사업자번호
recallFrgnCmpnyName	해외사업자 명	리콜대행인 경우 사용
makerCntryName	제조사 국가명	제조 공장 국가
makerName	제조사 명
makingCntryName	제조 국가명	제조 공장 국가
publishDate	공표일	yyyyMMdd 형태
publishRecallVol	리콜 범위	공표문 상의 리콜 수량
recallActionAmt	리콜 조치 수량
recallStaDate	리콜 시작일자
recallEndDate	리콜 종료일자
harmDscr	위해 내용
accidentCaseDscr	사고 사례
recallFiles	리콜사진 배열
fileDiv	파일 구분	전체사진, 부분사진
imageUrl	이미지 주소

4.3. 국외리콜정보 조회

HTTP Method	GET
HTTP URL	http://www.safetykorea.kr/openapi/api/recall/fRecallList.json?conditionKey={검색구분}&conditionValue={검색어}

◇ 요청 메시지 URL

◇ 요청 메시지 명세

항목명(영문)	항목명(국문)	항목구분	항목설명
conditionKey	검색구분	필수	all : 전체 recallProductName : 제품명 recallBrandName : 브랜드명 recallModelName : 모델명 publishDate : 공표일자 fRecallUid : 리콜아이디
conditionValue	검색어	필수

◇ 응답 메시지 형태

JSON

{

"resultCode": "2000",

"resultMsg": "성공",

"resultData": [

{

"fRecallUid": "42",

"recallModelName": "Acrobats1",

"recallModelCnt": "1",

"recallProductName": "뮤직박스완구",

"recallBrandName": "Trousselier",

"makerName": "회사정보없음",

"makingCntryName": "국외>아시아지역>중국",

"recallTypeName": "자발적리콜",

"recallPblshCntryName": "국외>유럽지역>프랑스",

"recallPblshOrgnName": "유럽 집행위원회",

"recallMeans": "기타",

"violateDscr": "- 제품은 쉽게 깨질 수 있고 작은 부품이 떨어질 수 있으며 유아가 부품을 삼킬 수 있기 때문에 질식 위험이 있음 - 제품은 완구 안전지침 및 관련 유럽기준인 EN 71-1을 따르지 않음",

"accidentCaseDscr": " 사고사례",

"publishActionDscr": "시장에서 자발적 회수 및 소비자에게 제품 위험에 대한 정보 제공",

"recallProductDscr": "- 회색 목재상자(11.5x11.5x11.5cm)로 물방울 무늬가 있으며 춤추는 광대 인형(자석) 2개가 있는 태엽 완구",

"recallUrl": null,

"publishDate": "20120427",

"signDttm": "20120611",

"imageUrl": "http://office.safetykorea.kr/fileData/fRecall/2020/04/1586324657410_sub_P.png,http://office.safetykorea.kr/fileData/fRecall/2020/04/1586325155803_all_P.png"

},

{

"fRecallUid": "2518",

"recallModelName": "Ref. 25312",

"recallModelCnt": "1",

"recallProductName": "딸랑이 박스",

"recallBrandName": "Lebao-Mlthogar",

"makerName": "Lebao-Mlthogar",

"makingCntryName": "국외>아시아지역>중국",

"recallTypeName": "명령에따른리콜",

"recallPblshCntryName": "국외>유럽지역>스페인",

"recallPblshOrgnName": "유럽 집행위원회",

"recallMeans": "수거",

"violateDscr": "- 노란 별 딸랑이가 작은 부품으로 쉽게 깨질 수 있어 유아가 입에 넣거나 삼킬 수 있으며 게 모양 딸랑이는 아이의 입에 걸릴 수 있기 때문에 질식 위험을 부과함 - 제품은 완구 안전지침 및 관련 유럽기준 EN 71-1을 따르지 않음",

"accidentCaseDscr": "없음",

"publishActionDscr": "세관에 의해 수입 거절",

"recallProductDscr": "딸랑이 박스 Box of rattles - 다양한 색상/모양의 딸랑이(게 모양, 파란 공과 노란 별 모양 딸랑이세트) - 투명창이 있는 판지 상자에 포장됨 - 판자상자에 Lebao, Baby Star, 100% 친환경소재 라고 표기되며, 뒷면에는 Mlthogar , 권장 사용연령, 참조번호, 바코드, 수입업체 식별정보가 표기됨",

"recallUrl": "https://www.baua.de/DE/Aufgaben/Forschung/Forschungsprojekte/f2396.html",

"publishDate": "20120203",

"signDttm": "20121113",

"imageUrl": "http://office.safetykorea.kr/fileData/recall/0000/00/2581/pharos_2581.png,http://office.safetykorea.kr/fileData/recall/0000/00/2581/pharos_2581.png"

}

]

}

◇ 응답 메시지 명세

항목명(영문)	항목명(국문)	항목설명
fRecallUid	국외리콜 아이디
recallModelName	모델명
recallModelCnt	모델갯수
recallProductName	제품명
recallBrandName	상표명
makerName	제조사명
makingCntryName	제조국
recallTypeName	리콜종류	자발적리콜, 권고에따른리콜, 명령에따른리콜
recallPblshCntryName	리콜공표국가명
recallPblshOrgnName	리콜공표기관명
recallMeans	리콜방법
violateDscr	위해내용
accidentCaseDscr	소비자 행동요령
publishActionDscr	조치사항
recallProductDscr	제품설명
recallurl	리콜 Url
publishDate	공표일
signDttm	등록일
imageUrl	이미지	,를 기준으로 이미지 사진 나눔

5. URL 링크

5.1. 개요

◇ 기존에 제공하던 제품 인증정보 상세 조회 팝업화면을 제공합니다.

◇ 인증 키는 필요하지 않습니다.

5.2. 제공 URL 명세

	제공 서비스	항목설명
1	인증번호 검색	구	http://safetykorea.kr/subPage.html?mode=4&subID=1&cate=productConfirmSearch
		신	http://www.safetykorea.kr/release/certificationsearch
2	인증번호 상세 조회	구	http://safetykorea.kr/search/search_pop.html?authNum=XX00000-0000
		신	http://www.safetykorea.kr/search/searchPop?certNum=XX00000-0000

6. 코드

6.1. 개요

6.2. 결과 코드 명세

결과코드	설명
2000	Success
2004	No Date
4000	Invalid Auth Key
4001	Invalid IP
4005	Invalid Parameter
5000	Internal Server Error Message: { Message }