국가기술표준원 SafetyKorea OpenAPI Version

국가기술표준원 SafetyKorea OpenAPI Version 1.4 2016-02-03

목차 1. 인터페이스방식... 2 2. API 방식... 3 2.1. 서비스 ID 발급및활용... 3 2.2. 제품인증정보서비스... 3 2.2.1. 제공서비스목록... 3 2.2.1.1. 제품인증정보조회... 3 2.2.1.2. 제품인증정보상세조회... 6 2.3. 제품리콜정보서비스... 8 2.3.1. 제공서비스목록... 8 2.3.1.1. 제품리콜정보조회... 8 2.3.1.2. 제품리콜정보상세조회... 10 3. URL 링크... 13 3.1. 개요... 13 3.2. 제공 URL 명세... 13 4. 코드... 14 4.1. 개요... 14 4.2. 결과코드명세... 14 1

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

2. API 방식 2.1. 서비스 ID 발급및활용 국가기술표준원 safetykorea 에서서비스 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 결과데이터 선택 요청한실제데이터가존재 2.2. 제품인증정보서비스 2.2.1. 제공서비스목록 제공서비스 항목설명 1 제품인증정보조회 전체조회, 인증번호, 제품명, 모델명 ( 로트번호 ), 상표명, 인증일자 2 제품인증정보상세조회 2.2.1.1. 제품인증정보조회 요청메시지 URL HTTP Method GET http://www.safetykorea.kr/openapi/api/cert/certificationlist.json?conditionkey= 검 HTTP URL 색구분 &conditionvalue= 검색어 요청메시지명세 항목명 ( 영문 ) 항목명 ( 국문 ) 항목구분 항목설명 conditionkey 검색구분 필수 all : 전체조회 certnum : 인증번호 productname : 제품명 3

conditionvalue 검색어필수 modelname : 모델명 brandname : 상표명 certdate : 인증일자 응답메시지형태 JSON "resultmsg": "Success.", "resultcode": 2000, "resultdata": [ "importername": "( 주 ) 비케이더블유 (BKW CO., LTD)", "categoryname": " 전기기기 > 주방용전열기구 > 전기토스터 ", "certorganname": " 한국화학융합시험연구원 (KTR)", "firstcertnum": "JU071259-15001", "modelname": "KT-3122", "certdate": "20150120", "certnum": "JU071259-15001", "certstate": " 적합 ", "certdiv": " 전기용품안전관리법대상 > 안전인증대상 ", "brandname": "", "productname": " 전기토스터 ", "certuid": 81680, "makername": "Kinwing Electric Industrial Co., Ltd.", "importdiv": " 수입 ", "importername": "( 유 ) 그룹세브코리아 ", "categoryname": " 전기기기 > 주방용전열기구 > 전기토스터 ", "certorganname": " 한국화학융합시험연구원 (KTR)", "firstcertnum": "JU07653-11001", "modelname": "TT1102", "certdate": "20150116", "certnum": "JU07653-11001B", "certstate": " 변경 ", "certdiv": " 전기용품안전관리법대상 > 안전인증대상 ", "brandname": "", "productname": " 전기토스터 ", 4

] "certuid": 82903, "makername": "Dongguan Hengli Yorkwell Manufactory", "importdiv": " 수입 ", "importername": "( 유 ) 그룹세브코리아 ", "categoryname": " 전기기기 > 주방용전열기구 > 전기토스터 ", "certorganname": " 한국화학융합시험연구원 (KTR)", "firstcertnum": "JU07653-12001", "modelname": "SERIE T19-B", "certdate": "20150116", "certnum": "JU07653-12001A", "certstate": " 변경 ", "certdiv": " 전기용품안전관리법대상 > 안전인증대상 ", "brandname": "", "productname": " 전기토스터 ", "certuid": 82904, "makername": "Dongguan Hengli Yorkwell Manufactory", "importdiv": " 수입 " 응답메시지명세항목명 ( 영문 ) 항목명 ( 국문 ) 항목설명 certuid 인증정보아이디 certnum 인증번호 ( 필증번호 ) certstate 인증상태 적합, 취소, 반납, 정지, 변경, 인증만료, 개선명령, 청문실시 certdate 인증일자 certdiv 인증구분 공산품 / 전기용품안전관리법의인증대상 productname 제품명 brandname 브랜드명 modelname 모델명 ( 로트번호 ) categoryname 법정제품분류명 importdiv 수입 / 제조구분 수입, 제조 makername 제조사명 makercntryname 제조국명 importername 수입사명 firstcertnum 최초인증번호 5

2.2.1.2. 제품인증정보상세조회 요청메시지 URL HTTP Method GET HTTP URL http://www.safetykorea.kr/openapi/api/cert/certificationdetail.json?certnum= 인증번호 요청메시지명세 항목명 ( 영문 ) 항목명 ( 국문 ) 항목구분항목설명 certnum 인증번호필수 응답메시지형태 JSON "resultmsg": "Success.", "resultcode": 2000, "resultdata": "importername": "( 주 ) 비케이더블유 (BKW CO., LTD)", "categoryname": " 전기기기 > 주방용전열기구 > 전기토스터 ", "certorganname": " 한국화학융합시험연구원 (KTR)", "firstcertnum": "JU071259-15001", "modelname": "KT-3122", "certdate": "20150120", "certnum": "JU071259-15001", "certstate": " 적합 ", "certdiv": " 전기용품안전관리법대상 > 안전인증대상 ", "brandname": "", "productname": " 전기토스터 ", "certuid": 81680, "makername": "Kinwing Electric Industrial Co., Ltd.", "importdiv": " 수입 ", "similarcertifications": [], "factories": [ "makername": "RalotIndustriesLtd." ], "certificationimageurls": [ "http://office.safetykorea.kr/filedata/certinfo/2014/07/b364r1086-4004_1.jpg", 6

"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" ], 응답메시지명세 항목명 ( 영문 ) 항목명 ( 국문 ) 항목설명 certnum 인증번호 ( 필증번호 ) certstate 인증상태 적합, 취소, 반납, 정지, 변경, 인증만료, 개선명령, 청문실시 certdate 인증일자 certdiv 인증구분 공산품 / 전기용품안전관리법의인증대상 productname 제품명 brandname 브랜드명 modelname 모델명 ( 로트번호 ) derivationmodels 파생모델목록 파생모델명을배열로제공 categoryname 법정제품분류명 importdiv 수입 / 제조구분 수입, 제조 makername 제조사명 makercntryname 제조국명 importername 수입사명 firstcertnum 최초인증번호 similarcertifications 연관인증번호목록 최초인증번호로조회되는인증번호배열목록 (josn 형태는인증번호조회목록과같음 ) factories 제조공장목록 제조공장정보를 json배열로제공 certificationimageurls 인증이미지 URL 목록 인증이미지의이미지 URL을배열로제공 - 복수제조공장 항목명 ( 영문 ) 항목명 ( 국문 ) 항목설명 makername 제조사명 makercntryname 제조국명 7

2.3. 제품리콜정보서비스 2.3.1. 제공서비스목록 제공서비스 항목설명 1 제품리콜정보조회 전체조회, 바코드, 제품명, 상표명, 모델명, 인증번호, 공표일자 2 제품리콜정보상세조회 2.3.1.1. 제품리콜정보조회 요청메시지 URL HTTP Method GET HTTP URL http://www.safetykorea.kr/openapi/api/recall/recalllist.json?conditionkey= 검색구분 &conditionvalue= 검색어 요청메시지명세 항목명 ( 영문 ) 항목명 ( 국문 ) 항목구분 항목설명 conditionkey 검색구분 필수 all : 전체조회 barcodenum : 바코드 productname : 제품명 brandname : 상표명 modelname : 모델명 certnum : 인증번호 publishdate : 공표일자 conditionvalue 검색어 필수 응답메시지형태 JSON "resultdata": [ "certnum": "", "recalluid": 802, "recallbrandname": " 락프로 ", "recalltypename": " 명령에따른리콜 ", "recallmodelname": "M120, S120", "recallproductname": " 디지털도어록 ", "recallcmpnyname": "( 주 ) 인터크리에이티브 ", "recallcmpnydivname": " 제조 ", 8

"barcodenum": "", "publishdate": "20120710", "makername": "( 주 ) 인터크리에이티브 ", "certnum": "", "recalluid": 801, "recallbrandname": "H-gang security, EPIC, Deayoung", "recalltypename": " 명령에따른리콜 ", "recallmodelname": "SMART TAP, EPIC, DHT-2200(D-NF-T-NK-S)", "recallproductname": " 디지털도어록 ", "recallcmpnyname": "( 주 ) 혜강씨큐리티 ", "recallcmpnydivname": " 제조 ", "barcodenum": "", "publishdate": "20120709", "makername": "( 주 ) 혜강씨큐리티 ", "certnum": "", "recalluid": 800, "recallbrandname": "LENKEN, UBIHOME, NAVIEN", "recalltypename": " 명령에따른리콜 ", "recallmodelname": " 도어록 :DL NW-600A( 단종 ), ADR-10, AD8015( 단종 ), NDL-2000( 단종 ) / 멀티도어폰 :UDP-100 / 공동현관기 :HLPC-7100,ULP200R", "recallproductname": " 도어록 / 공동현관기 ", "recallcmpnyname": "( 주 ) 경동원 ", "recallcmpnydivname": " 제조 ", "barcodenum": "", "publishdate": "20120710", "makername": "( 주 ) 경동원 " ], "resultmsg": "Success.", "resultcode": 2000 응답메시지명세항목명 ( 영문 ) 항목명 ( 국문 ) 항목설명 recalluid 리콜아이디 9

recallproductname 제품명 recallmodelname 모델명 리콜모델목록 ( 콤마 (,) 구분 ) makername 제조사명 recalltypename 리콜종류 publishdate 공표일 yyyymmdd 형태 barcodenum 바코드 recallbrandname 상표명 certnum 인증번호 인증번호목록 ( 콤마 (,) 구분 ) recallcmpnydivname 리콜사업자구분 수입,, 제조, 판매, 리콜대행 recallfrgncmpnyname 해외사업자명 리콜대행인경우사용 recallinqrytel 리콜문의전화 recallcmpnyname 리콜사업자명 2.3.1.2. 제품리콜정보상세조회 요청메시지 URL HTTP Method GET HTTP URL http://www.safetykorea.kr/openapi/api/recall/recalldetail.json?recalluid= 리콜아이디 요청메시지명세 항목명 ( 영문 ) 항목명 ( 국문 ) 항목구분항목설명 recalluid 검색어필수 응답메시지형태 JSON "resultmsg": "Success.", "resultcode": 2000, "resultdata": "recallenddate": "20121031", "recallcmpnyname": "( 주 ) 혜강씨큐리티 ", "makingcntryname": " 국내 > 아시아지역 > 대한민국 ", "recallmeans": " 기타 ", "categoryname": " 디지털도어록 > 디지털도어록 ", "recalluid": 801, "recallfiles": [ 10

"filediv": " 전체제품사진 ", "imageurl": "http://office.safetykorea.kr/filedata/0000/00/recall/816/pharos_816_1.gif", "filediv": " 조치전사진 ", "imageurl": "http://office.safetykorea.kr/filedata/0000/00/recall/816/pharos_816_2.gif", "filediv": " 조치후사진 ", "imageurl": "http://office.safetykorea.kr/filedata/0000/00/recall/816/pharos_816_3.gif" ], "makeamt": 6631, "recallcmpnyssn": "117-81-64320", "recalltypename": " 명령에따른리콜 ", "makername": "( 주 ) 혜강씨큐리티 ", "recallcmpnydivname": " 제조 ", "publishdate": "20120709", "makercntryname": " 국내 > 아시아지역 > 대한민국 ", "recallbrandname": "H-gang security, EPIC, Deayoung", "recallmodelname": "SMART TAP, EPIC, DHT-2200(D-NF-T-NK-S)", "recallproductname": " 디지털도어록 ", "makeraddr": " 서울양천구신정동 1254 양천벤처타운 103호 ", "barcodenum": "", "certnum": "", "accidentcasedscr": " 보고된사고사례는없음 ", "harmdscr": " 최근일부핸드폰 (USIM) 및교통카드 IC CHIP의고유번호 (UID) 가동일한방식의카드가디지털도어록에등록사용시동일한 IC CHIP을사용하는미등록핸드폰 (USIM) 및교통카드로인증허용됨.\r\n 단, 해당제조사에서직접공급한카드만을키로등록해서사용하고있는소비자의경우해당되지않음.\n", "publishrecallvol": "" 응답메시지명세항목명 ( 영문 ) 항목명 ( 국문 ) 항목설명 recalluid 리콜아이디 recallproductname 제품명 11

recallmodelname 리콜모델명 리콜모델목록 ( 콤마 (,) 구분 ) recallmodelcnt 리콜모델개수 recalltypename 리콜종류 publishdate 공표일 yyyymmdd 형태 barcodenum 바코드 recallbrandname 상표명 certnum 인증번호 인증번호목록 ( 콤마 (,) 구분 ) categoryname 법정제품분류명 recallcmpnydivname 리콜사업자구분 수입,, 제조, 판매, 리콜대행 recallinqrytel 리콜문의전화 recallcmpnyname 리콜사업자명 recallcmpnyssn 리콜사업자번호 recallfrgncmpnyname 해외사업자명 리콜사업자가리콜대행인경우 makingcntryname 제조국가명 제조공장국가 makercntryname 제조사국가명 makername 제조사명 makerssn 제조사사업자번호 productitemname 제품품목명 publishrecallvol 리콜범위 공표문상의리콜수량 recallactionamt 리콜조치수량 recallstadate 리콜시작일자 recallenddate 리콜종료일자 recallmeans 수거등의방법 harmdscr 위해내용 accidentcasedscr 사고사례 12

3. URL 링크 3.1. 개요 기존에제공하던제품인증정보상세조회팝업화면을제공합니다. 인증키는필요하지않습니다. 3.2. 제공 URL 명세 제공서비스 URL 1 인증번호검색 구 http://safetykorea.kr/subpage.html?mode=4&subid=1&cate=productconfirm Search 신 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 13

4. 코드 4.1. 개요 4.2. 결과코드명세 결과코드 설명 2000 Success. 2004 No Data. 4000 Invalid Auth Key. 4001 Invalid IP. 4005 Invalid Parameter. 5000 Internal Server Error. Message: Message 14