인크루트 내일검색 공식블로그 ::

[누구나 쉬운 API] '간단 키워드 결과'는 어떻게 하는 건가요?

from 오픈 API 2008/08/12 17:47

내일검색의 검색결과를 여러분의 블로그나 카페, 홈페이지에서 바로 확인할 수 있는 서비스 입니다. 원하는 조건에 따라 자동으로 생성된 스크립트를 삽입만 하시면 됩니다.

1.	제공되는 서비스 옵션 - 노출방식, 결과에 들어갈 로고, 로고 위치, 설정키워드, 노출 개수
2.	신청은 이렇게 하시면 되요
3.	사용은 이렇게 하시면 되요 - 삽입된 곳에 설정된 키워드에 대한 결과값이 페이지를 불러올 때마다 내일검색에서 해당 키워드로 검색을 하는 것과 동일한 결과를 보여줍니다. 내일검색에 업데이트 된 채용정보들이 동시간에 적용됩니다.
4.	수정을 원하시면, 스크립트를 새로 생성받으시면 되요~
5.	그래도 잘 모르시겠다면? -문의답변처리 게시판을 참고하시거나 문의하기(Tel:02-2186-9259)를 이용해 주세요~
자, 지금 ‘간단 키워드 결과’를 사용해보시겠어요?

openapi, 내일검색, 쉬운API, 열린API, 오픈API

받은 트랙백이 없고, 댓글이 없습니다.

[누구나 쉬운 API] '검색창과 결과'는 어떻게 하는 건가요?

from 오픈 API 2008/08/12 17:44

	내일검색의 검색창을 여러분의 블로그나 카페, 홈페이지에 쉽고 편리하게 삽입하고 해당 결과 또한 하나의 페이지에서 언제든지 채용정보를 검색 해 볼 수 있는 서비스입니다. 원하는 조건에 따라 자동으로 생성된 스크립트를 삽입만 하시면 됩니다.

	1.	제공되는 서비스 옵션 - 검색창 가로 길이, 검색버튼 색상, 검색창의 로고, 노출방식, 설정키워드, 리스팅 개수
	2.	신청은 이렇게 하시면 되요
	3.	사용은 이렇게 하시면 되요 - 삽입된 검색창에 키워드를 입력하면 선택했던 방식(기본형 or 간편보기형)으로 검색결과가 페이지에 뿌려집니다~
	4.	수정을 원하시면, 스크립트를 새로 생성받으시면 되요~
	5.	그래도 잘 모르시겠다면? - 문의답변처리 게시판을 참고하시거나 문의하기 (Tel:02-2186-9259)를 이용해 주세요~
	자, 지금 ‘검색창과 결과’를 사용해보시겠어요?

openapi, 내일검색, 쉬운API, 열린API, 오픈API

받은 트랙백이 없고, 댓글이 없습니다.

[누구나 쉬운 API] '간단검색창'은 어떻게 하는 건가요?

from 오픈 API 2008/08/12 17:33

내일검색의 검색창을 여러분의 블로그나 카페, 홈페이지에 쉽고 편리하게 삽입하여 언제든지 채용정보를 검색 해 볼 수 있도록 스크립트를 자동으로 생성해 드리는 서비스 입니다.

1.	제공되는 서비스 옵션 - 검색창 가로 길이, 검색버튼 색상, 검색창의 로고 삽입 여부
2.	신청은 이렇게 하시면 되요
3.	사용은 이렇게 하시면 되요 - 삽입된 검색창에 직종, 지역, 기업명 등의 다양한 키워드를 입력하시면, 새 창으로 씨올의 채용정보 검색결과가 뜹니다~
4.	수정을 원하시면, 스크립트를 새로 생성받으시면 되요~
5.	그래도 잘 모르시겠다면? -문의답변처리 게시판을 참고하시거나 문의하기(Tel:02-2186-9259)를 이용해 주세요~
자, 지금 ‘간단검색창’을 사용해보시겠어요?

간단검색창, 내일검색, 쉬운API, 열린API, 오픈API

받은 트랙백이 없고, 댓글이 없습니다.

echo API

from 오픈 API 2008/08/12 17:21

API 서비스의 정상적 응답을 확인 합니다.

1. 요청 URL
- http://naeilapi.incruit.com/api/?method=echo

2. 요청 인자

인자	설명`	기타
method	함수명 "method=echo" (고정)	필수
apikey	발급받은 APIKey 값	필수
out	출력 형식 지정	XML(기본) JSON

3. 출력 항목

항목	설명
Response	확인 정보
status	상태
returntime	응답시간

4. 결과 예제
 <?xml version="1.0" encoding="utf-8" ?> <Response status="OK" returntime="11/17/2007 12:02:09 AM" />

5. 비고/에러 메시지
100 : 성공
101 : 키없음
apikey 항목이 없습니다.
103 : 메소드명 없음
method 항목이 없습니다.
104 : 유효하지 않은 메소드
정의되지 않은 method 입니다.
200 : 존재하지 않는 키
201 : 키 유효일자가 지났음
400 : Bad Request
요청실패문법상 오류가 있어, 서버가 요청사항을 이해하지 못함
401 : Unauthenticated
권한 없음 (접속실패)이 에러는 서버에 로그온 하려는 요청사항이 서버에 들어있는 권한과 비교했을 때 맞지 않음
403 : Forbidden
금지(수행접근 금지)
404 : Not Found
문서를 찾을 수 없음.웹 서버가 요청한 파일이나 스크립트를 찾지 못함
409 : Conflict
500 : Internal Server Error
서버 내부 오류
501 : Not Implemented Not Implemented
502 : Bad gateway
게이트웨이 상태 나쁨/서버의 과부하 상태
503 : Service Unavailable
외부 서비스가 죽었거나 현재 멈춘 상태 또는 이용할 수 없는 서비스

echoapi, openapi, 내일검색, 에코, 열린API, 오픈API

받은 트랙백이 없고, 댓글이 없습니다.

채용검색 API

from 오픈 API 2008/08/12 17:12

입력된 키워드에 따라 검색결과를 제공합니다.
다양한 필터링 조건값 설정으로 꼭 필요한 결과값을 얻을 수 있습니다.

1. 요청 URL
- http://naeilapi.incruit.com/api/?method=search

2. 요청 인자

인자	설 명	기 타
method	함수명 "method=search" (고정)	필수
apikey	발급받은 APIKey 값	필수
q	검색어	필수
out	출력 형식 지정	XML(기본) JSON RSS
start	반환될 결과 시작 번호	start=10 이면 10번째 결과값부터 반환됨 0 (기본)
count	반환 될 결과리스트 개수	10 (기본)
rgn1	조건설정-지역코드	전체 (기본) 서울 - 11 부산 - 12 대구 - 13 인천 - 14 광주 - 15 대전 - 16 울산 - 17 경기 - 18 강원 - 19 충북 - 20 충남 - 21 전북 - 22 전남 - 23 경북 - 24 경남 - 25 제주 - 26 특구 - 40 전국 - 59 해외 - 98 기타 - 99
sry	조건설정-급여코드	전체 (기본) 시급 3500원 미만 - 11 시급 3500~5000원 - 12 시급 5000~1만원 - 13 시급 1만원 이상 - 14 일급 3만원 미만 - 21 일급 3~5만원 - 22 일급 5만원 이상 - 23 주급 10만원 미만 - 31 주급 10~30만원 - 32 주급 30만원 이상 - 33 월급 50만원 미만 - 41 월급 50~100만원 - 42 월급 100만원 이상 - 43 건별 1~5만원 - 51 건별 5~10만원 - 52 건별 10만원 이상 - 53 연봉 1800만원 미만 - 61 연봉 1800~2400만원 - 62 연봉 2400~3000만원 - 63 연봉 3000~4000만원 - 64 연봉 4000~5000만원 - 65 연봉 5000~1억 - 66 연봉 1억 이상 - 67 회사 내규 - 98 면접후 결정 - 99
crr	조건설정-경력코드	전체 (기본) 경력무관 - 0 신입 - 1 1~2년 - 2 2~3년 - 3 3~5년 - 4 5~10년 - 5 10년이상 - 6
schol	조건설정-학력코드	전체 (기본) 고등학교졸업 - 10 대학(2,3년)졸업 - 13 대학교(4년)졸업 - 16 석사이상 - 22 박사이상 - 26 학력무관 - 99
scale	조건설정-기업규모	전체 (기본) 소기업 - 1 중기업 - 2 대기업 - 3 벤처기업 - 4 외국계/해외기업 - 5 정부/공공 - 6 교육기관 - 7
epty	조건설정-채용형태	전체 (기본) 정규직 - 1 계약직 - 2 병역특례 - 3 인턴 - 4 파견대행 - 5 헤드헌팅 - 6 아르바이트 - 7 프리랜서 - 8 생활직 - 9 기타 - 98

3. 출력 항목

항목	설 명
TotalCount	총 검색 건수
Job_Tiitle	공고명
Employ_Ty_Nm	채용 방식 - 정규직, 계약직, 아르바이트 등을 의미
Comp_Nm	구인 회사명
Region_Nm	근무지 - 지역 큰 분류
Region_Det_Nm	근무지역 상세 - 지역 상세 정보
Subway_Str	근무지 인접 지하철역
Schol_Nm	학력
Career_Nm	경력 - 신입, 경력무관 등을 의미
Salary_Nm	급여
Job_Cont	구인 상세 내용
Cl_Invite_Start_Dt	구인 모집 시작일
Cl_Invite_Close_Dt	구인 모집 마갑일
Employ_limit	마감일 정보 - "채용시까지", "상시채용", "마감일"
Source_Site_Nm	Site 이름
Source_Site_Url	Site URL
Link_Url	구인정보 URL
Cl_Date	수집 날짜

4. 결과 예제
 <?xml version="1.0" encoding="utf-8" ?> <channel> <TotalCount>12687</TotalCount> <item> <Job_Title> <![CDATA[ 현대자동차 영업사원을 모집합니다. ]]> </Job_Title> <Employ_Ty_Nm> <![CDATA[ 정규직 ]]> </Employ_Ty_Nm> <Comp_Nm> <![CDATA[ 현대자동차신천판매영업소 ]]> </Comp_Nm> <Region_Nm> <![CDATA[ 서울 ]]> </Region_Nm> <Region_Det_Nm> <![CDATA[ 송파구 ]]> </Region_Det_Nm> <Subway_Str> <![CDATA[ 성내 ]]> </Subway_Str> <Schol_Nm> <![CDATA[ 고등학교졸업 ]]> </Schol_Nm> <Career_Nm> <![CDATA[ 경력무관 ]]> </Career_Nm> <Salary_Nm> <![CDATA[ ]]> </Salary_Nm> <Job_Cont> <![CDATA[ 고객서비스 마인드 소유자 - 남자는 군필 및 면제자 - 타사 영업 경력자 및 일반영업 경력자 특별우대 - 초보자도 가능가능 * 서울시 송파, 광진, 강남, 서초, 강동, 경기 성남 인근거주자에 한함 ※ 자동차 영업에 의지가 있고 강한 행동력을 보유한 자 ※ ** ... ]]> </Job_Cont> <Cl_Invite_Start_Dt> <![CDATA[ 20071113 ]]> </Cl_Invite_Start_Dt> <Cl_Invite_Close_Dt> <![CDATA[ 20071127 ]]> </Cl_Invite_Close_Dt> <Employ_Limit> <![CDATA[ 마감일 ]]> </Employ_Limit> <Source_Site_Nm> <![CDATA[ 인크루트 ]]> </Source_Site_Nm> <Source_Site_Url> <![CDATA[ http://www.incruit.com/ ]]> </Source_Site_Url> <Link_Url> <![CDATA[ http://www.incruit.com/jobdb/02.asp?pid=584223&jid=2771379 ]]> </Link_Url> <Cl_Date> <![CDATA[ 2007-11-14 01:09:41 ]]> </Cl_Date> </item> </channel>

5. 비고/에러 메시지
100 : 성공
101 : 키없음
apikey 항목이 없습니다.
102 : 쿼리 없음
q 항목이 없습니다.
103 : 메소드명 없음
method 항목이 없습니다.
104 : 유효하지 않은 메소드
정의되지 않은 method 입니다.
200 : 존재하지 않는 키
201 : 키 유효일자가 지났음
102 : 쿼리 없음
q 항목이 없습니다.
400 : Bad Request
요청실패문법상 오류가 있어, 서버가 요청사항을 이해하지 못함
401 : Unauthenticated
권한 없음 (접속실패)이 에러는 서버에 로그온 하려는 요청사항이 서버에 들어있는 권한과 비교했을 때 맞지 않음
403 : Forbidden
금지(수행접근 금지)
404 : Not Found
문서를 찾을 수 없음.웹 서버가 요청한 파일이나 스크립트를 찾지 못함
409 : Conflict
500 : Internal Server Error
서버 내부 오류
501 : Not Implemented Not Implemented
502 : Bad gateway
게이트웨이 상태 나쁨/서버의 과부하 상태
503 : Service Unavailable
외부 서비스가 죽었거나 현재 멈춘 상태 또는 이용할 수 없는 서비스

받은 트랙백이 없고, 댓글이 없습니다.

API의 응답형식들(XML,RSS,JSON)에 대해 알려주세요

from 오픈 API 2008/08/12 16:10

API 는 XML, JSON, RSS 3가지 형식을 지원하고 있습니다.
지속적으로 지원형식을 늘려나갈 계획 입니다.

1. XML
- XML (Extensible Markup Language) 형식의 출력결과를 지원 합니다.
- XML 에 대한 자세한 내용은 w3c/XML 을 참조바랍니다.


<?xml version="1.0" encoding="utf-8" ?> 
<channel>
	<TotalCount>1057</TotalCount> 
	<item>
	 ...
	</item>
	<item>
	 ...
	</item>	
	...
</channel>

2. JSON
- JSON (JavaScript Object Notation)은 간단한 데이터 교환 형식입니다.
- JSON에 대한 자세한 내용은 json.org 를 참조바랍니다.


{
	"channel": {
		"TotalCount":"2232",
		"item":[
				{...} ,
				{...} ,
				...
		]
	}
}

3. RSS
- RSS (Really Simple Syndication) 2.0 형식의 출력결과를 지원 합니다.
- RSS에 대한 자세한 내용은 RSS 2.0 을 참조바랍니다.


<?xml version="1.0" encoding="utf-8" ?> 
<rss version="2.0" xmlns:dc="http://purl.org/dc/elements/1.1/">
	<channel>
		<title>...</title>
		<link>...</link> 
		<language>...</language> 
		<description>...</description>
		<copyright>...</copyright> 
		<lastBuildDate>...</lastBuildDate> 
		<webMaster>...</webMaster>
		<item>
		...
		</item>
		<item>
		...
		</item>
		...
	</channel>
</rss>

받은 트랙백이 없고, 댓글이 없습니다.

REST 요청형식이 무엇인가요?

from 오픈 API 2008/08/12 16:07

REST는 REpresentational State Transfer의 약자로, 사용하기에 가장 단순한 요청 형식입니다.

이는 단순한 URL 요청방식을 따르며 HTTP GET 또는 POST 방식으로 요청을 보냅니다.

API에서 사용하는 REST 방식 URL은 http://naeil.incruit.com/api/ 입니다.

API가 정상적으로 응답하고 있는지 Test 하려면 다음과 같이 요청을 해보세요.
http://naeilapi.incruit.com/api/?method=echo&apikey=userapikey

REST 요청에 대한 기본 응답형식은 XML 형식 입니다.
응답에 대한 특정 형식 (XML.JSON,RSS) 을 지정하면 그에 대한 결과를 받을 수 있습니다.

openapi, rest, 내일검색, 열림API, 오픈API

받은 트랙백이 없고, 댓글이 없습니다.

API key가 무엇인가요?

from 오픈 API 2008/08/12 16:07

내일검색 API를 사용하려면 사용자 인증 키가 있어야 합니다.
사용된 API키를 참고로 API 사용에 대한 통계와 문제점을 기록하고 개선 합니다.
내일검색 API의 상업적 사용을 목적으로 한다면 담당자와 연락(Tel:02-2186-9259) 후 협의하여 주시기 바랍니다.
지금 API Key 발급을 신청하세요!!!

받은 트랙백이 없고, 댓글이 없습니다.

열린 API가 무엇인가요?

from 오픈 API 2008/08/12 16:06

내일검색 서비스는 채용정보 검색서비스로서, 열린 API는 채용정보 검색 서비스를 더 많은 사람들에게 유용하고 간편하게 제공 하고자 마련되었습니다.

사용을 위해서는 APIKey 등록을 하여 주시기 바랍니다.

제공되는 API 사용이 어려우신 분들은 '누구나 쉬운 API'을 이용하여 쉽고 편하게 사용할 수 있습니다.

1. API 요청형식
- REST 형식을 따릅니다.

2. API 응답형식
- XML, JSON, RSS 방식을 지원 합니다.

3. API 인코딩 방식
- UTF-8 방식을 따르고 있습니다.

받은 트랙백이 없고, 댓글이 없습니다.

내일검색 OpenAPI 용 PHP 예제

from 오픈 API 2008/08/03 22:03

안녕하세요? 내일검색 웹마스터입니다.

내일검색은 OpenAPI를 통해 사이트의 기능 확장을 도와드리고 있습니다. OpenAPI를 사용할 수 있다면 자신의 사이트에 내일검색의 기능을 넣을 수 있습니다. 이 중에서 PHP 언어를 이용한 OpenAPI 중 채용검색 API를 보여드리려고 합니다. 채용검색 API를 하실 수 있다면 인기검색어 API는 그리 어렵지 않습니다.

OpenAPI를 사용하기 위해서는 다음과 같은 준비물이 필요합니다.

- PHP 4 혹은 PHP 5
- UTF-8(유니코드)가 지원되는 텍스트 에디터

내일검색의 검색결과는 유니코드로 출력이 되기 때문에, API의 사용도 유니코드로 해주셔야 글씨가 깨지지 않습니다. 메모장에서는 다음과 같이 저장하시면 됩니다(Windows XP 이상).

유니코드, 유니코드(Big Endian), ANSI, UTF-8 중에 UTF-8로 해주시면 됩니다. 다른 텍스트에디터에서도 UTF-8로 저장해주시면 됩니다. UTF-8이 지원되지 않는 텍스트에디터는 사용할 수 없습니다.

첨부파일을 보시면, 4개의 파일이 있는데 간단하게 그 역할을 소개하겠습니다.

- style.css : 스타일시트 파일입니다. 검색 결과 부분에서의 모양새를 결정할 수 있습니다.
- index.php : 검색 초기 화면입니다. 직접 사용하실 때에는 각 사이트별로 달라질 수 있습니다.
- search.php : 검색 결과를 출력하는 파일입니다. simplexml.php와 연결되어있으며, XML로 넘어오는 검색 결과를 적절하게 파싱해서 출력합니다.
- simplexml.php : 간단한 XML 파서입니다.

그렇다면 index.php 부터 살펴보겠습니다.

<html>
<head>
    <title>내일 검색 오픈API 예제</title>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body style="text-align:center">
    <h2>내일검색 OpenAPI 예제</h2>
    <!-- 이부분 부터는 검색에 관한 부분입니다. form부터 /form까지입니다 -->
    <form action="./search.php" method="GET">
        <input type="text" name="query">
        <input type="submit" value="검색">
        <hr/>
        <label for="category">
    </form>
</body>
</form>

우선 meta 태그를 이용해서 문자셋을 UTF-8로 해줍니다. 웹 브라우저가 "이 문서는 UTF-8 형식이군" 이라고 알아차리기 위해서입니다. 보통 euc-kr도 많이 사용합니다만, 내일검색의 검색결과가 UTF-8로 나오기 때문에 UTF-8로 해주셔야 합니다(검색 질의에서 코드가 안맞으면 한국어로 검색이 되지 않습니다).

form 태그의 action이 search.php로 가있으니 이 질의는 search.php로 넘어갈 것입니다. method는 GET 방식인데, 검색엔진에서는 개인정보를 특별하게 노출 할 것이 없으므로 POST 방식을 사용하지 않았습니다. POST 방식을 사용하는 경우 search.php의 변수 부분 중 $_GET를 $_POST로 변경해 주셔야 합니다.

index.php는 매우 단순하니 이정도로 보고 넘어가서, 중요한 파일인 search.php를 살펴보도록 하겠습니다.

search.php는 크게 두 부분으로 나뉘어져 있습니다. 첫 번째 부분은 내일검색 OpenAPI 서버에 접속해서 검색질의어에 해당하는 검색 결과를 XML로 가져오는 부분이며, 두 번째 부분은 simplexml.php가 파싱한 구조화된 데이터를 적절하게 화면에 보여주는 부분입니다. 우선 내일검색 OpenAPI 서버에 접속하여 질의 결과를 가져오도록 하겠습니다.

<?php
    // OpenAPI Example for PHP4, 5
    // PHP5에서 실행하기를 권합니다.
    
    require_once "simplexml.php";

    // 오픈API 키가 있어야 검색을 할 수 있습니다. 키는 내일검색에서 받으 실 수 있습니다.
    $apikey = "여러분의 API Key를 입력하세요";
    
    // 검색페이지에서 입력한 검색질의어입니다.
    $user_query = $_GET['query'];

    // HTTP Query 하기 위한 준비 과정
    $host = "www.incruit.com";
    $port = 80;
    $timeout = 30; // 30초가 지나도록 반응이 없으면 시간초과에러가 납니다

    // 내일검색 옵션
    $out = "xml"; // json, rss, xml

    // 동시에 보이는 검색 결과 수 (기본값 10)
    if (!$_GET['count'])
    {
        $_GET['count'] = 10;
        $count = $_GET['count'];
    }

    // 시작번호 기본값 지정
    if (!$_GET['page']) // 페이지가 안 정해져있으면, 시작위치는 0으로 한다.
    {
        $_GET['page'] = 1;
        $start = ($_GET['page'] - 1) * $_GET['count']; // (페이지-1) * 동시에 보이는 결과
    }
    else
    {
        $start = ($_GET['page'] - 1) * $_GET['count']; // (페이지-1) * 동시에 보이는 결과
    }

    $query = "?apikey={$apikey}&method=search&q={$user_query}&start={$start}&count={$count}&out=xml";

    // HTTP Socket 연결
    $socket = fsockopen('naeilapi.incruit.com', $port, $errno, $errstr, $timeout);

    if (!$socket) {
        echo "$errstr ($errno)<br />\n";
    }
    else
    {
        $out = "GET /api/";
        $out .= $query;
        $out .= " HTTP/1.1\r\n";
        $out .= "Host: naeilapi.incruit.com\r\n";
        $out .= "Connection: Close\r\n\r\n";

        fwrite($socket, $out);
    }

    // 헤더 읽기.
    $api_header = '';
    while (!feof($socket))
    {
        $out = fgets($socket,512);
        if (trim($out) == '') {
            break;
        }
        $api_header .= $out;
    }

    // 본문 읽기.
    $api_body = '';
    while (!feof($socket))
    {
        $out = fgets($socket,512);
        $api_body .= $out;
    }
    
    $idx = strpos(strtolower($api_header), 'transfer-encoding: chunked');

    if ($idx > -1) {
        $temp = '';
        $offset = 0;
        do {
            $idx1 = strpos($api_body, "\r\n", $offset);
            $chunkLength = hexdec(substr($api_body, $offset, $idx1 - $offset));

            if ($chunkLength == 0) {
                break;
            }
            else
            {
                $temp .= substr($api_body, $idx1 + 2, $chunkLength);
                $offset = $idx1 + $chunkLength + 4;
            }
        }while (true);
        $api_body = $temp;
    }

    fclose($socket); // 접속 종료.

index.php에 비해서 매우 길지만, 차근차근 살펴보겠습니다. 우선 가장 중요한 것은 $apikey 부분입니다. OpenAPI는 API 키를 받아서 사용하도록 되어있습니다. API Key의 발급은 이곳에서 하시면 됩니다.
동시에 보이는 검색결과수가 있는데, 한 화면에 몇 건의 채용 정보가 표시 될지를 정하는 부분입니다. 기본값은 10이며, 원하시는 대로 조절하실 수 있습니다. 그리고 $query를 잘 보시기 바랍니다.

$query = "?apikey={$apikey}&method=search&q={$user_query}&start={$start}&count={$count}&out=xml";

apikey(API키)가 들어갔고, method는 search(키워드 검색이며 실시간 인기검색어와 자체 시험인 echo가 있습니다)가 들어갔습니다. q는 사용자가 넣은 키워드가 들어가며, start는 몇 번째 채용정보 부터 보여줄 것인지를 결정합니다. count는 앞서 설명드린 대로 한 화면에 보여질 채용정보의 수이며, out은 출력 방식입니다. 이 파일에서는 XML로 작업합니다(JSON 방식이 있습니다).

또한 이 파일은 REST 방식으로 데이터를 받아오는데, API 사이트와의 소켓 연결을 통해서 HTTP 데이터를 직접 받아옴을 뜻합니다. 그 이후 부분은 받아온 HTTP 데이터를 가공하여 simplexml이 읽을 수 있도록 만드는 과정이라고 보시면 됩니다. fclose 함수를 통해 소켓 연결을 종료하면서 첫 번째 부분은 끝이 납니다.

두 번째 부분을 설명하기 앞서, simplexml.php 부터 보도록 하겠습니다. 다음은 소스입니다.

<?php
    class exXML {
        var $totalCount;             // 해당 공고 수
        var $vals = null;
        var $currTag;
        var $is_item;
        var $rec_num = 0;
        
        function exXML () {
        }

        function parse($data) {
            $this->parser = xml_parser_create();

            xml_set_object($this->parser, $this);
            xml_set_element_handler($this->parser, 'tagOpen', 'tagClose');
            xml_set_character_data_handler($this->parser, 'cdata');

            if (!xml_parse($this->parser, $data)) {
                echo "XML Parsing Error!";
            }
            
            xml_parser_free($this->parser);

            return true;
        }

        function tagOpen($parser, $tag, $attr)
        {
            global $is_item;
            global $rec_num;
            // 현재 어떠한 태그를 파싱하고 있는지 저장합니다.
            // 내일검색의 데이터는 모두 CDATA 방식이기에 여기에서 바로 파싱이 되지 않습니다.

            $this->currTag = strtolower($tag); // 대문자로 된 태그를 소문자로 일괄 변환합니다.

            // item(검색 결과의 시작인 경우)
            if ($this->currTag == "item"  && $is_item == 0) {
                $is_item = 1;
                $rec_num++;
            }
        }

        function tagClose($parser, $tag)
        {
            global $rec_num;
            global $is_item;


            $tag = strtolower($tag);
            if ($tag == "item") {
                $is_item = 0;
            }
        }

        function cdata($parser, $tag)
        {
            global $rec_num;
            global $vals;
            global $is_item;

            // 공고의 총 갯수를 구합니다.
            if ($this->currTag == "totalcount") {
                $this->totalCount = $tag;
            }
            // 공고 내용을 배열에 저장합니다.
            if ($is_item == 1) {
                switch ($this->currTag) {
                    case "job_title":
                        $vals[$rec_num]['title'] .= $tag;
                        break;
                    case "employ_ty_nm":
                        $vals[$rec_num]['employType'] .= $tag;
                        break;
                    case "comp_nm":
                        $vals[$rec_num]['comp'] .= $tag;
                        break;
                    case "region_nm":
                        $vals[$rec_num]['region'] .= $tag;
                        break;
                    case "region_det_nm":
                        $vals[$rec_num]['region_det'] .= $tag;
                        break;
                    case "subway_str":
                        $vals[$rec_num]['subway'] .= $tag;
                        break;
                    case "schol_nm":
                        $vals[$rec_num]['degree'] .= $tag;
                        break;
                    case "career_nm":
                        $vals[$rec_num]['career'] .= $tag;
                        break;
                    case "salary_nm":
                        $vals[$rec_num]['salary'] .= $tag;
                        break;
                    case "c_addr_str":
                        $vals[$rec_num]['addr'] .= $tag;
                        break;
                    case "job_cont":
                        $vals[$rec_num]['jobcont'] .= $tag;
                        break;
                    case "cl_invite_start_dt":
                        $vals[$rec_num]['startDate'] .= $tag;
                        break;
                    case "cl_invite_close_dt":
                        $vals[$rec_num]['endDate'] .= $tag;
                        break;
                    case "employ_limit":
                        $vals[$rec_num]['limit'] .= $tag;
                        break;
                    case "source_site_nm":
                        $vals[$rec_num]['source'] .= $tag;
                        break;
                    case "source_site_url":
                        $vals[$rec_num]['sourceUrl'] .= $tag;
                        break;
                    case "link_url":
                        $vals[$rec_num]['linkUrl'] .= $tag;
                        break;
                    case "cl_date":
                        $vals[$rec_num]['addDate'] .= $tag;
                        break;
                }
            }
        }

        function display()
        {
            global $vals;
            return $vals;
        }

    }
?>

simplexml은 검색결과를 화면에 출력할 수 있도록 구조화시켜주는 역할을 합니다. 일종의 문자인식기라고 보시면 되겠습니다.

검색결과 XML에는 일정한 순서와 패턴이 존재하기 때문에 이 패턴을 알면 많은 데이터를 틀리지 않게 분류해서 저장할 수 있습니다. 검색 결과는 매 건이 ITEM 태그로 시작해서 ITEM 태그로 끝납니다. 이것을 프로그램이 잡아내서 각 항목별로 자료를 넣어줍니다. 자세한 xml 파싱용 함수에 대해서는 php 관련 문서를 참조해주세요^^

case 문으로 채워진 부분은 내일검색 API 검색 결과에서 나오는 모든 항목을 정리해주는 부분입니다.

function display()는 차곡차곡 정리한 결과를 얻어올 때 사용합니다. 누가 얻어올까요? search.php가 다시 얻어옵니다. 이제 search.php의 두 번째 부분으로 넘어가겠습니다.

    $p = new exXML();
    $p->parse($api_body);

    // 결과를 가공하기 위해 배열을 가져옵니다.
    $showdata = $p->display();
    $totalCount = $p->totalCount;
?>

<?php
    // 이부분부터는 실제로 검색결과가 출력되는 부분입니다.
    // 따로 스킨으로 처리해서 완전히 분리할 수도 있습니다.
?>

<html>
<head>
<title><?=$_GET['query'] ?>    에 대한 검색 결과 </title>
<link rel="stylesheet" href="./style.css" type="text/css" />
</head>
<body>
<div id="page">
    <div id="searchForm">
        <form action="./search.php" method="GET">
            내일검색 <input type="text" name="query">
            <input type="submit" value="검색">
            <hr/>
            <label for="category">
        </form>
    </div>
    <div id="statics">
        <p class="totalcount"><b><?=$_GET['query'] ?></b>에 대해 총 <?=$p->totalCount ?> 건의 채용 정보가 검색되었습니다.</p>
        <?
            $view_start = $start +1;
            if ($count > $p->totalCount) {
                $view_end = $p->totalCount;
            }
            else
            {
                $view_end = $start + $count;
            }
        ?>
        <p class="currentpage">현재 <?=$view_start ?>번 부터 <?=$view_end ?>번 까지 보고 있습니다.</p>
    </div>
    <div id="result">
    <?
        foreach ($showdata as $key => $value)
        {
            echo "<p class='title'><b>".$value['comp']."</b> - "."<a href='".$value['linkUrl']."'>".$value['title']."</a></p>";
            echo "<p class='subinfo'>";
            if ($value['region_det'] != "")
            {
                echo $value['region_det']." | ";
            }
            if ($value['employType'] != "")
            {
                echo $value['employType']. " | ";
            }
            if ($value['career'] != "")
            {
                echo $value['career']." | ";
            }
            if ($value['salary'] != "")
            {
                echo $value['salary']." | ";
            }
            if ($value['startDate'] != 0)
            {
                $temp_year = substr($value['startDate'], 0, 4);
                $temp_month = substr($value['startDate'], 4, 2);
                $temp_day = substr($value['startDate'], 6, 2);

                echo $temp_year."/".$temp_month."/".$temp_day." ~ ";
            }
            else
            {
                echo " ~ ";
            }

            if ($value['endDate'] != 0)
            {
                $temp_year = substr($value['endDate'], 0, 4);
                $temp_month = substr($value['endDate'], 4, 2);
                $temp_day = substr($value['endDate'], 6, 2);
                
                echo $temp_year."/".$temp_month."/".$temp_day." | ";
            }
            else
            {
                echo " | ";
            }

            if ($value['limit'] != "")
            {
                echo $value['limit']." | ";
            }
        }

    ?>
    </div>
    <div id="pageBrower">
    <?
        // 페이지를 보여주는 부분

        // 시작점을 정해줍니다.
        $p_start = (int) ($page / 10); // 페이지 번호를 10개씩 보여주기 위해 10을 나눠줍니다.

        // 10페이지 이후를 보고 있는 경우 앞으로 돌아가는 링크를 만듭니다.
        if ($p_start != 0)
        {
            $p = ($p_start) * 10 - 1;

            $url = "search.php";
            $url .= "?query={$user_query}&page={$p}&count={$count}";

            echo "<a href='{$url}'>◀</a>";
        }

        // 페이지 번호가 나오는 부분입니다.
        for ($i=1;$i < 11;$i++)
        {
            $p = $p_start * 10 + $i;

            if (($p * 10) < $totalCount)
            {
                if ($p != $page)
                {
                    $url = "search.php";
                    $url .= "?query={$user_query}&page={$p}&count={$count}";

                    echo "[<a href='{$url}'>".$p."</a>]";
                }
                else
                {
                    echo "[{$p}]";
                }
            }
        }
        
        // 검색결과가 현재 페이지 번호들이 표현할 수 있는 번호보다 큰 경우 이후의 번호가 나올 수 있게 링크를 겁니다.
        if ($p * 10 < $totalCount)
        {
            $p++;

            $url = "search.php";
            $url .= "?query={$user_query}&page={$p}&count={$count}";

            echo "<a href='{$url}'>▶</a>";
        }
    ?>
    </div>
</div>
</body>
</html>

HTML과 PHP가 같이 있습니다. 검색 결과를 실제로 화면에 출력하기 때문에 그렇습니다. simplexml에서 정리한 데이터를 순서대로 출력해주는 부분입니다. 그리고 페이지 번호를 적절하게 보여주는 기능도 넣었습니다.

지금까지 PHP를 이용하여 내일검색 키워드 검색 API를 사용하는 방법을 알아보았습니다. 예제가 완벽하진 않지만 충분히 도움이 되었으리라 믿어 의심치 않습니다^^;; 참고 사이트와 첨부파일을 덧붙이면서 이 긴 글(?)을 마치겠습니다.

참고사이트

BENEGLO BLOG : 네이버의 OpenAPI를 PHP로 만드는 방법을 소개하신 페이지입니다.
http://kr.php.net/manual/en/book.xml.php : PHP 공식 사이트입니다. XML에 관련된 부분은 대개 영어로 되어있습니다.

첨부파일

naeil_openapi_for_php.zip

PHP, 내일검색, 열린API

받은 트랙백이 없고, 댓글이 없습니다.

내일검색, WoC(Winter of Code) 두개 부문 수상!

from 오픈 API 2008/03/28 15:17

안녕하세요! 내일검색 웹마스터 오랫만에 인사드립니다^^

지난 12월부터 올 3월까지 약 4개월간 진행되었던 WoC(Winter of Code)에서

내일검색(구 씨올,Cxiol)을 주제로 한 두 팀이 이번에 수상을 하게 되었습니다!

첫번째로는 위자드웍스와 내일검색의 API를 매쉬업하여 내일검색 위젯을 개발한

조영운(멘토,위자드웍스)님, 안광현(멘티)님의 팀이 디보트상을 수상하였습니다.

씨올의 API와 위자드닷컴의 WZDAPI를 이용하여 위젯을 개발해 주셨습니다.

두번째로, 내일검색과 라이프팟의 API를 매쉬업하여 내일검색 켈린더를 개발하고 설치형 블로그의

플러그인까지 개발한 신기배(멘토,라이프팟)님, 이연주(멘티)님의 팀이 이번 WoC 금상을 수상하였습니다.

씨올의 채용정보 검색과 라이프팟의 UI API를 매쉬업하여 테터툴즈&티스토리에 플러그인으로 사용할 수 있게

켈린더 제작해 주셨습니다.

수상하신(?) 두 팀, 진심으로 축하드리구요, 앞으로도 멋진 서비스로 또 다시 건승하시길 빌겠습니다.

두 팀의 결과물은 4월중에 정식으로 릴리즈될 예정입니다.

수상식 사진을 첨부합니다 ^^

저희 팀 멤버분들(우측 세분)^^ 왼쪽부터 이주연님, 조영운님, 안광현님

켈린더팀, 신기배님 이주연님

조영운님 수상 소감~

우리팀입니다 ^^ 특별출연 내일검색 오규덕차장님(맨 왼쪽), 이성열과장님(맨 오른쪽)

WoC 참가자 단체사진입니다. 모두 수고하셨습니다~

- 그리고 보너스로.. -

행사의 진정한 막을 내리는, 필수코스 뒷풀이 +_+

woc, 내일검색, 뒷풀이, 메쉬업, 시상식, 신기배, 씨올, 안광현, 이연주, 조영운

받은 트랙백이 없고, 댓글이 없습니다.

오픈API 활용방법(1)

from 오픈 API 2007/11/27 18:57

오픈 API는 시작되었습니다.

별거 아닌 것 같지만,
장래에 벌어질 일을 생각하면 심장이 마구 뜁니다.

이제 이렇게 외치고 싶습니다.
" 취업정보는 누구의 소유물이 될 수 없고,
누구나가 어디서든지 볼수 있는 세상!
진정한 공공재다~~!! "라고요^^

현재, '열린API'로 서비스를 시작하였습니다.

'누구나 쉬운 API'는 '간단 검색창'기능이 제일 편리합니다.
'검색창과 결과' '간단 검색창'은 업그레이드 하고 있는
플래쉬기반의 작업으로 사용함이 좋을 것 같다는 생각입니다.

'개발자를 위한 열린API'는 한번 도전해보세요~
작업진행중에 어려움이 있으면 저희 개발자가 적극 도와드릴 겁니다.( cxiol@incruit.com 또는 전화 2186-9259 )

검색엔진을 도입하기 어려운 취업정보가 필요한 공공기관, 대학, 일반 취업사이트, 지방 취업사이트등에도
무료로 검색엔진을 제공하고자 하오니, '사업자 제휴신청'주시면 도와드리겠습니다.

매월 여러가지 기능과 매쉬업 내용을 드리도록 하겠습니다.
감사감사^^

개방, 공유, 열린API, 오픈API, 참여, 취업정보

받은 트랙백이 없고, 댓글이 없습니다.

오픈API 준비중~

from 오픈 API 2007/10/09 19:17

오픈API를 준비하고 있습니다.

흠...오픈API를 어떻게 이해해야 할까요?

개인(홈피-블로그)
카페
공공기관/대학
교육기관
일반기업
취업정보사이트도....

씨올의 검색기능과 검색결과값을 사용토록 하기 위함입니다.

어떤분은 특정 분야-지역-근무형태에 대해서...
어떤분은 검색창만...
어떤분은 전체 결과값을...

최대한 제한없이 드릴 수 있는 모든 기능을 제공하고 싶은 마음입니다.
그래서, 어는 공간에서도 '나의-우리의 취업정보'가 검색되고
관리될 수 있는 날을 꿈꿉니다.

나만의 정보, 맞춤형 정보, 오픈API

받은 트랙백이 없고, 댓글 4개가 달렸습니다.

댓글을 달아 주세요

smile 2007/10/11 09:14 address modify / delete reply
오픈 API 기대 만땅되네요~

제약없는 채용정보 검색과 관리라....

화이팅!! 하셔서 빨리 사용해 볼 수 있게 해주세요~~
cxiol 2007/10/12 18:50 address modify / delete reply
여러분들이 관심 보여주시고 있습니다.

다른 오픈api와는 다르게!
보다 혁신적으로 진행해 볼 생각입니다!

세상을 거꾸로 보면, 우리가 보지 못했던 또 다른 가치를 발견하리란
믿음으로용~
궁굼이..? 2007/10/13 11:10 address modify / delete reply
오픈 api를 통해 얻고 싶은 것이 무엇이지요?
기능과 대상에 제한은 있는지요?
cxiol 2007/10/15 09:59 address modify / delete reply
씨올에 오지 않더라도, 구직자가 방문한 곳에서 '원하는 취업정보'를 검색하고
또는 원하는 형태로 받아볼 수 있는 환경을 제공해 드리고 싶습니다.

씨올에서 구동되는 모든 기능을 드리고 싶습니다.
개인이든 단체든 상관없습니다.
비즈니스 기업일 경우에는 '제휴를 통한 제공'이 더 부드러울 것 같습니다.

cxiol@incruit.com으로 제휴메일 주세요~
감사합니다.

항목	설 명
ExtractDate	인기 검색어 생성 기간
Rank	순위
Keyword	인기검색어

인자	설 명	기 타
method	함수명 "method=hotword" (고정)	필수
apikey	발급받은 APIKey 값	필수
out	출력 형식 지정	XML(기본) JSON RSS

'오픈 API'에 해당되는 글 14건

Trackback Address >> http://blog.naeil.incruit.com/trackback/93

댓글을 달아 주세요

Trackback Address >> http://blog.naeil.incruit.com/trackback/92

댓글을 달아 주세요

Trackback Address >> http://blog.naeil.incruit.com/trackback/91

댓글을 달아 주세요

Trackback Address >> http://blog.naeil.incruit.com/trackback/90

댓글을 달아 주세요

Trackback Address >> http://blog.naeil.incruit.com/trackback/89

댓글을 달아 주세요

Trackback Address >> http://blog.naeil.incruit.com/trackback/88

댓글을 달아 주세요

Trackback Address >> http://blog.naeil.incruit.com/trackback/87

댓글을 달아 주세요

Trackback Address >> http://blog.naeil.incruit.com/trackback/86

댓글을 달아 주세요

Trackback Address >> http://blog.naeil.incruit.com/trackback/85

댓글을 달아 주세요

Trackback Address >> http://blog.naeil.incruit.com/trackback/84

댓글을 달아 주세요

Trackback Address >> http://blog.naeil.incruit.com/trackback/70

댓글을 달아 주세요

Trackback Address >> http://blog.naeil.incruit.com/trackback/42

댓글을 달아 주세요

Trackback Address >> http://blog.naeil.incruit.com/trackback/21

댓글을 달아 주세요

Trackback Address >> http://blog.naeil.incruit.com/trackback/10

댓글을 달아 주세요