오픈 API 사용 가이드
운전면허정보조회 서비스 이용시 오픈 API KEY조회를 사용하시려면 오픈 API KEY 발급을 받으셔야 합니다.
오픈 API KEY발급- 오픈 API 이용 자격 - 서비스 대상
- 본 시스템에서 제공되는 운전자격조회서비스는 자동차운송사업법에 근거하여 “자동차 대여사업자”를 대상으로 서비스 됩니다.
따라서 서비스 이용자격은 자동차대여사업자에 한정되며, 오픈 API를 이용한 인터페이스는 승인된 사업자 및 승인된 사업자의 특정 시스템에서만 접근/사용이 가능합니다. - 오픈 API를 이용한 조회방법 - 개발 및 테스트
- 공단에서 제공하는 오픈 API 사용을 위해서는 다음의 절차에 따라 개발 및 테스트가 요구되며, 공단시스템관리자의 최종 확인 후 운영시스템 접근이 가능합니다.
오픈 API를 이용한 조회 방법은 홈페이지의 “오픈 API”를 참고 바랍니다. -
오픈 API 사용신청
공단시스템관리자에게 문의오픈 API 사용에 대하여 시스템관리자에게 문의 후
소정의 신청서를 제공 받습니다.신청서 제출 및 승인
오픈 API사용기업 → 공단오픈 API 사용 신청서를 작성/제출하고 승인을
얻습니다. * 사업자 등록증 등 첨부자료는
신청서 제출처에 확인 바랍니다.승인YES
테스트용 Key발급
공단 → 오픈 API사용기업테스트 서버의 오픈 API에
접근할 수 있는 Key를
공단으로부터 발급 받습니다.테스트용 IP정보 제공
오픈 API사용기업 → 공단공단에 설치된 테스트 서버는
지정된 특정 IP만을 접근 허락
합니다. 따라서 오픈 API 화면 개발 시
사용할 IP를 공단에 제공하여
Open을 요청합니다.개발 및 테스트
오픈 API 사용기업 자체 테스트테스트서버에 접근하여
개발과 테스트를 진행합니다.연동 통합 테스트
기업개발자 + 공단시스템관리자공단이 정한 테스트 항목별로 본
시스템 관리자 참관 하에 전체
통합테스트를 진행합니다.테스트결과 제출 및 승인
오픈 API사용기업 → 공단테스트 결과를 소정의 양식에
작성하여 제출하고 승인을
받아야합니다.승인YES
운영서버 접속 안내
공단시스템관리자 →오픈 API사용업체운영서버 접속안내에 따라 서비스를
이용합니다. - 오픈 API를 이용한 조회방법
- 오픈 API 인터페이스 개발이 완료되고 통합테스트에 의해 안전한 접근이 확인/허가된 사업자는 이하의 절차에 따라 서비스를 이용할 수 있습니다.
-
(기업) 회원등록신청
웹페이지 화면홈페이지에서 (기업)회원 등록을
신청합니다. * 사업자등록증 등 첨부(기업) 회원등록승인
공단 관리자신청된 내용은 공단 관리자에 의해
검토/승인되며, 승인결과는
유선 또는 온라인으로 신청시
등록된 연락처로 통보됩니다.공동인증서 로그인
웹페이지 화면API발급 받기 전에
공동인증서 로그인을 합니다.오픈 API Key 발급요청/발급
웹페이지 화면홈페이지의 오픈 API 관련 메뉴에 접근하여
오픈 API 사용을 위한 Key를 발급받습니다.
오픈 API Key는 기업을 식별하는 식별자입니다.
* 분실 및 불법적 사용 시 발급받은 기업에
불이익이 발생할 수 있으며, Key 관리의
책임은 발급받은 기업에 있습니다.공단 오픈 API 호출
단건 및 복수 건 검증요청단건 및 복수건의 운전면허정보를
검증 요청할 수 있습니다.
검증결과 정보제공
검증결과는 코드값으로 전달되며,
코드에 대한 설명은 연동가이드를
참고바랍니다.API 검증 완료