Open API 센터

기본정보

학교정보 목록 URL

XML 형태 URL : //www.career.go.kr/cnet/openapi/getOpenApi.xml?apiKey=인증키

JSON 형태 URL : //www.career.go.kr/cnet/openapi/getOpenApi.json?apiKey=인증키

요청변수 (request parameter)

학교정보 요청변수 (request parameter)

요청변수	타입	값	설명
apiKey	String[필수]		OPENAPI 등록 신청 후 관리자로부터 발급받은 KEY값
svcType	String[필수]	api	api
svcCode	String[필수]	SCHOOL	리스트 : SCHOOL
contentType	String	Xml Json	xml or json 형태 (URL 에서 .xml, .json 생략) 예: //www.career.go.kr/cnet/openapi/getOpenApi?apiKey=인증키&contentType=xml
gubun	String[필수]	초등학교 중학교 고등학교 대학교 특수학교 기타	학교 분류
region	String	전체	지역
sch1	String	전체	학교유형1
sch2	String	전체	학교유형2
est	String	전체	설립유형 대학교 : 국립, 사립, 공립 대안학교 : 인가, 비인가, 위탁형
thisPage	String		현재페이지
perPage	String		한페이지당 건수
searchSchulNm	String		검색어(초등학교, 중학교, 고등학교, 대학교, 특수학교, 기타)
URL 생성 >

출력결과필드 (response field)

상위노드상세 : 노드위치 <dataSearch>

학교정보 출력결과필드 상위노드상세 : 노드위치 <dataSearch> - 노드, 타입, 설명

노드	타입	설명
<content>		전체 검색 결과 리스트
<totalCount>	String	전체 검색 결과수
<schoolName>	String	학교명
<schoolGubun>	String	학교종류
<schoolType>	String	학교유형
<estType>	String	설립유형
<region>	String	지역
<adres>	String	주소
<collegeinfourl>	String	mycollege 접속 정보(대학교)
<link>	String	링크 link : 상세페이지 링크, open: 새창으로 띄움

에러결과노드 상세 : 노드위치 <result> <content>

학교정보 에러결과노드 상세 : 노드위치 <result> <content> - 노드, 속성, 설명

노드	속성	설명
<code>		결과코드(0 : 성공, 음수 : 실패)
<message>		처리결과 메시지

결과 XML

<?xml version = "1.0" encoding = "euc-kr" standalone="yes" ?>
	<dataSearch>
		<content>
			<region>경기도</region>
			<estType>사립</estType>
			<schoolGubun>전문대학</schoolGubun>
			<schoolName>경기과학기술대학교</schoolName>
			<totalCount>495</totalCount>
			<adres>경기 시흥시 정왕동 2121-3</adres>
			<link>http://www.gtec.ac.kr</link>
			<campusName>본교</campusName>
			<seq>767</seq>
			<collegeinfourl>
			http://www.mycollege.kr/web/college/webCollegeInfo_main.do?univcode=73147000
			</collegeinfourl>
			<schoolType>전문대학</schoolType>
		</content>
		<content>
			<region>서울특별시</region>
			<estType>사립</estType>
			<schoolGubun>대학(4년제)</schoolGubun>
			<schoolName>경기대학교</schoolName>
			<totalCount>495</totalCount>
			<adres>서울특별시 서대문구 충정로2가 71</adres>
			<link>http://www.kyonggi.ac.kr</link>
			<campusName>서울캠퍼스</campusName>
			<seq>14</seq>
			<collegeinfourl>null</collegeinfourl>
			<schoolType>일반대학</schoolType>
		</content>
	<dataSearch>
				

학교정보 검색 코드값

지역별 학교정보 검색 코드 표

program	parameter	value	name
지역	region	100260	서울특별시
		100267	부산광역시
		100269	인천광역시
		100271	대전광역시
		100272	대구광역시
		100273	울산광역시
		100275	광주광역시
		100276	경기도
		100278	강원도
		100280	충청북도
		100281	충청남도
		100282	전북특별자치도
		100283	전라남도
		100285	경상북도
		100291	경상남도
		100292	제주도

학교유형별(고등학교) 학교정보 검색 코드 표

program	parameter	value	name
학교유형(고등학교)	sch1	100362	일반고
		100363	특성화고
		100364	특수목적고
		100365	자율고
		100366	기타

학교유형별(대학교) 학교정보 검색 코드 표

program	parameter	value	name	bigo(sch2)
학교유형(대학교)	sch1	100322	전문대학	100324 : 전문대학 100325 : 기능대학(폴리텍대학) 100326 : 사이버대학(2년제) 100327 : 각종대학(전문)
		100323	대학(4년제)	100328 : 일반대학 100329 : 교육대학 100330 : 산업대학 100331 : 사이버대학(4년제) 100332 : 각종대학(대학)

설립유형별 학교정보 검색 코드 표

program	parameter	value	name
설립유형(대학교)	estType	100334	국립
		100335	사립
		100336	공립