이번에는 jQuery를 이용 한 bit.ly API 코딩 실전으로 들어가겠습니다.

기본적으로 jQuery(JavaScript)를 이용한 외부 서버 접속은 보안상의 이슈로 처리 되지 않습니다만, JSON의 경우는 JavaScript로도 보안상의 문제 없이 외부 서버의 JSON을 처리 할 수 있습니다. bit.ly의 API는 JSON을 지원하기때문에 우리는 jQuery AJAX의 JSON을 이용하여 동적으로 Shorten URL을 서비스 할 수 있습니다.

jQuery로 Shorten메소드 호출

앞서 3장에서 다룬 내용대로 “http://www.blueiblog.com/ko/archives/1976″을 줄일때 우리는 “http://api.bit.ly/shorten?version=2.0.1&longUrl=http://www.blueiblog.com/ko/archives/1976&login=xxxx&apiKey=xxxxxxxxxxxx”와 같이 Shorten URL을 요청했습니다.

그럼 3장과 같은 내용의 함수를 jQuery로 바꾸어보도록 하겠습니다.

/**
 * License by Blueⓘ
 *
 * @param String longURL 짧게 변경할 긴 문자열의 URL
 * @return String 짧게 변환된 URL
 */
function getShortURL(longURL) {
	var ret;
	$.getJSON(
		"http://api.bit.ly/shorten?version=2.0.1&longUrl="+longURL+"&login=xxxx&apiKey=xxxxxxxxxxxx",
		function(data) {
			ret = data.results[url].shortUrl;
		}
	);
	return ret;
} 
 
$(function() {
	alert(getShortURL("http://test.com"));
});
// OUTPUT : http://bit.ly/9ICmwA

이렇게 바뀔 수 있겠네요.. 위 코드는 테스트 없이 그냥 즉석에서 소스를 jQuery용으로 변경 한 것입니다. 테스트 없이 코드를 올려서 죄송합니다 ㅠ.ㅠ 혹 문제가 없을거라고 믿으나 있다면 댓글로 노티 부탁드리겠습니다.

그럼 앞의 두 강좌를 기본으로 PHP를 이용한 bit.ly API 코딩하기 실전으로 들어가도록 하겠습니다. 이 API 코딩법만 익히게 되면 다른 bit.ly API를 이용하는것도 어렵지 않으니 집중하고 내용을 이해 하도록 노력해 주세요.

P.S. 그리고 댓글좀 써주세요 ㅡㅡ; 댓글 없는 포스팅을 보게되면 강좌를 연재할 의욕이 꺽인답니다. ^^

PHP로 Shorten메소드 호출

이제 어떠한 방식으로 데이터를 주고받는지 알게 되었다면 PHP를 이용하여 bit.ly의 API를 이용하여 짧은 URL을 얻어오는 방법을 설명 하겠습니다. 이번 강의에서 사용될 PHP의 함수는 아래와 같습니다.

1. file_get_contents : 로컬내 파일 또는 원격지의 파일 내용을 문자열로 가져오는 함수
2. json_decode : JSON으로 만들어진 문자열을 JSON 객체로 변환 해주는 함수

위 두 함수는 모두 PHP 코어의 일부분으로 따로 설치 하실 필요는 없습니다. 다만 PHP 버젼에 따라 작동되지 않을 수 있습니다.

그럼 간단하게 긴URL을 bit.ly에 던져서 짧은URL을 얻어 출력하는 내용으로 코딩 해보도록 하겠습니다.

$data = file_get_contents("http://api.bit.ly/shorten?version=2.0.1&longUrl=http://www.blueiblog.com/ko/archives/1976&login=xxxx&apiKey=xxxxxxxxxxxx");
$data = json_decode($data);
foreach($data->results as $row) {
        $surl = $row->shortCNAMEUrl;
}
echo $surl;

그럼 이번에는 함수를 만들어서 언제든 빼 쓸 수 있도록 해보겠습니다.

/**
 * License by Blueⓘ
 *
 * @param String longURL 짧게 변경할 긴 문자열의 URL
 * @return String 짧게 변환된 URL
 */
function getShortURL($longURL) {
        $data = file_get_contents("http://api.bit.ly/shorten?version=2.0.1&longUrl=".$longURL."&login=xxxx&apiKey=xxxxxxxxxxxx");
        $data = json_decode($data);
        foreach($data->results as $row) {
                $surl = $row->shortCNAMEUrl;
        }
        return $surl;
}
 
echo getShortURL("http://test.com");
// OUTPUT : http://bit.ly/9ICmwA

이번에는 앞서 설명했던 내용을 토대로 shorten메소드에 대해서 알아보도록 하겠습니다. shorten메소드는 bit.ly의 API중 우리가 가장 많이 사용하게 될 메소드입니다. shorten메소드는 http://www.blueiblog.com/ko/archives/1976 와 같은 긴 주소를 http://bit.ly/b4ihSW 와 같이 짧게 줄여주는 역활을 합니다.

그럼 shorten메소드의 사용법에 대해서 알아보도록 하겠습니다.

Shorten Method 요청 및 결과

Shorten메소드는 아래와 같은 파라미터를 입력해야 사용 할 수 있습니다. 입력해야 할 파라미터와 그 설명은 아래와 같습니다.

그럼 위 메소드를 어떻게 사용하는지 알아보도록 하겠습니다. 우선 http://www.blueiblog.com/ko/archives/1976 주소를 짧게 변경하고 싶다면 아래와 같이 shorten메소드를 호출 해 보겠습니다. 브라우저의 주소 입력 창에 아래와 같이 입력해보세요. (아래 이미지를 클릭하시면 원본 사이즈로 보실 수 있습니다.)

http://api.bit.ly/shorten?version=2.0.1&longUrl=http://www.blueiblog.com/ko/archives/1976&login=xxxx&apiKey=xxxxxxxxxxxx

이와 같이 브라우져에 데이터를 요청하게 되면 다음과 같은 결과를 얻을 수 있습니다.

{
    "errorCode": 0, 
    "errorMessage": "", 
    "results": {
        "http://www.blueiblog.com/ko/archives/1976": {
            "hash": "b4ihSW", 
            "shortCNAMEUrl": "http://bit.ly/9pTARb", 
            "shortKeywordUrl": "", 
            "shortUrl": "http://bit.ly/9pTARb", 
            "userHash": "9pTARb"
        }
    }, 
    "statusCode": "OK"
}

위 결과 처럼 Shorten메소드의 호출 결과는 JSON데이터로 반환 됩니다. format파라미터를 xml로 입력하면 xml로 결과를 반환 받을 수 있습니다. 아래는 xml로 반환 받은 경우의 결과 데이터 입니다.

<bitly>
	<errorCode>0</errorCode>
	<errorMessage/>
	<results>
		<nodeKeyVal>
			<shortKeywordUrl/>
			<hash>b4ihSW</hash>
			<userHash>9pTARb</userHash>
			<nodeKey>http://www.blueiblog.com/ko/archives/1976</nodeKey>
			<shortUrl>http://bit.ly/9pTARb</shortUrl>
			<shortCNAMEUrl>http://bit.ly/9pTARb</shortCNAMEUrl>
		</nodeKeyVal>
	</results>
	<statusCode>OK</statusCode>
</bitly>

위 결과 처럼 xml로도 데이터를 반환 받을 수 있습니다. 하지만 우리는 기본포맷인 json으로 받은 데이터를 이용하여 프로그램을 작성 할 것입니다.

마이크로 블로깅으로 인해 숏URL 서비스가 인기를 얻는 세상이 왔습니다. 옛날 같으면 쓰지도 않던 기능인데 말이죠 ^^

저 역시 블로그 글을 출판하게 되면 자동으로 트위터에 포스트의 제목과 URL을 추가하여 출판하고 있습니다. 하지만 역시 블로그의 주소는 길기에… 어쩔수 없이 Short URL기능을 이용해야 합니다. 그래서 bit.ly의 Short URL API에 대해 알아 보았습니다.

그럼 PHP를 이용하여 bit.ly의 Short URL을 가져오는 방법에 대해서 알아보도록 하겠습니다.

bit.ly의 API Key 얻기

여느 API와 마찬가지로 API를 이용하기 위해서는 API Key를 얻어야 합니다. 우선 http://bit.ly의 홈페이지로 이동 한 후 회원가입을 합니다. 회원 가입후 어카운트 정보를 확인하면 아래와 같이 API Key가 보여집니다. (제 API Key 보안을 위해 ^^; 해당 부분은 모자이크 처리 했습니다.)

물론 이렇게 얻은 API Key가 유출되었다면 우측의 Reset키를 누르시면 새로운 API Key를 발급 받으실수 있습니다.

bit.ly API 목록

bit.ly는 다른 OPEN API에 비해 API의 종류가 매우 간단합니다. 우선 API 리스트는 아래와 같습니다.

1. shorten : 우리가 제일 필요로 하는 API로 URL을 bit.ly의 짧은 URL로 바꾸어주는 API입니다.
2. expand : bit.ly/xxxxx 형식으로 되어 있는 Short URL을 원래의 URL로 바꾸어주는 API입니다.
3. info : bit.ly의 Short URL에 해당하는 정보를 보여주는 API입니다.
4. stats : bit.ly Short URL의 트래픽 및 레퍼러 정보를 보여주는 API입니다.
5. errors : bit.ly에서 사용되는 ERROR CODE를 보여주는 API입니다.

P.S. bit.ly의 API 문서 페이지는 http://code.google.com/p/bitly-api/wiki/ApiDocumentation 입니다.

그래서 한번 정리해봅니다.