티스토리 API 사용 방법 : 액세스 토큰(Access Token, OAuth) 발급 간편 꿀팁 | 티스토리 액세스 토큰 간편 생성 서비스

◼︎ 목차 업데이트 : --01

티스토리 API란?
1. 티스토리 오픈 API 사용을 위한 앱 등록하기
2. 발급된 앱아이디/시크릿키 확인하기
3. 인증 코드(Auth Code) 발급 받기
4. 액세스 토큰 (Access Token) 발급 받기
티스토리 액세스 토큰 간편 생성 서비스 활용하기
맺음말
도움이 될 만한 연관 추천 글

◼︎ 티스토리 API란?

티스토리(Tistory)는 제 3자 외부 프로그램을 통한 데이터 통신/관리 작업을 손쉽게 수행할 수 있는 API(Application Programming Interface)를 제공하고 있습니다.

티스토리가 제공하는 API를 활용해서 티스토리의 데이터를 프로그래밍적(Programmatically)으로 자유롭게 생성/읽기/수정/삭제(CRUD, Create/Read/Update/Delete)할 수 있는 장점이 있습니다.

이러한 티스토리 API를 사용하기 위해서는, 먼저 몇 가지 필요한 정보를 등록하고 관련 데이터를 발급 받아야 합니다.

[참고] 티스토리(Tistory) 오픈 API 공식 문서 : tistory.github.io/document-tistory-apis/

◼︎ 1. 티스토리 오픈 API 사용을 위한 앱 등록하기

티스토리(Tistory)에 로그인된 상태에서 홈페이지 맨 하단의 "오픈 API" 링크를 클릭하거나, 아래의 링크를 통해 "앱 등록" 페이지에 접속합니다.

티스토리 오픈 API 사용을 위한 앱 등록 페이지 : www.tistory.com/guide/api/manage/register

"오픈 API" 앱 등록 페이지에 들어 간 뒤, 필요한 정보를 모두 입력합니다.

서비스명
설명
로고
서비스 URL
서비스 형태
서비스 권한
콜백(Callback) URL

이 중 가장 핵심적인 정보는 "콜백(Callback) URL"입니다.

티스토리가 제공하는 API를 사용하기 위한 준비 과정 중 요구되는 "콜백(Callback) URL" 정보는 OAuth를 이용한 사용자 인증(Authentication) 과정에서 입력한 정보가 등록된 정보와 동일한 데이터인지 확인 용도로 사용됩니다.

"콜백(Callback) URL" 입력란에 현재 가장 자주 사용하는 메인 티스토리 블로그 주소(URL)를 입력합니다. (예: https://xxxxxx.tistory.com, 주소(URL) 마지막에 '슬래시(/)'가 없도록 주의합니다.)

입력하는 정보 중 '콜백(Callback) URL'과 '서비스 URL'은 동일하게 입력할 수 있습니다.

모든 정보를 입력한 뒤 하단의 '등록' 버튼을 클릭해서 앱 등록을 완료합니다.

◼︎ 2. 발급된 앱아이디/시크릿키 확인하기

"앱 등록"을 완료하면, "앱 관리" 탭에 방금 등록한 앱 정보를 확인할 수 있습니다.

"설정" 링크를 클릭하면, 해당 앱에 대한 정보와 함께, 신규 발급된 "앱 아이디(App ID)", "시크릿 키(Secret Key)" 정보가 나타나는 것을 확인할 수 있습니다.

◼︎ 3. 인증 코드(Auth Code) 발급 받기

신규 생성된 "앱 아이디(App ID)", "시크릿 키(Secret Key)"와 기존에 입력한 "콜백(Callback) URL"을 이용하여, 아래의 링크를 통해 인증 코드(Authentication Code)를 확인합니다.

https://www.tistory.com/oauth/authorize?
 client_id={client-id}
 &redirect_uri={redirect-uri}
 &response_type=code
 &state={state-param}

위의 링크를 브라우저에 입력한 뒤, 새로 열리는 창에서 "허가하기" 버튼을 클릭하면, 입력한 "콜백 URL (Redirect URI)"로 리디렉션(자동 이동)됩니다.

리디렉션(자동 이동)된 웹페이지의 주소(URL)에서 "code" 파라미터 값을 복사해서 보관해 둡니다. (예: https://xxxxx.xxxxxx.com/?code=XXXXXXXXXXXXX )

이 과정에서 티스토리 API를 사용하기 위해 제공되는 관련 용어가 프로세스별로 일치하지 않고, 티스토리 API 관련 공식 문서에도 별다른 부연 설명이 없기 때문에, 용어에 헷갈리지 않도록 주의합니다.

콜백 URL (Callback URL) = 리다이렉트 URI (Redirect URI)
앱 아이디 (App ID) = 클라이언트 아이디 (Client ID)
시크릿 키 (Secret Key) = 클라이언트 시크릿 (Client Secret)

◼︎ 4. 액세스 토큰 (Access Token) 발급 받기

위의 과정을 통해 확보한 "앱 ID (Client ID)", "시크릿 키 (Client Secret)", "콜백 URL (Redirect URI)", "인증 코드 (Code)"를 사용하여, 티스토리 API 사용을 위한 "액세스 토큰 (Access Token)" 데이터를 발급 받습니다.

GET https://www.tistory.com/oauth/access_token?
 client_id={client-id}
 &client_secret={client-secret}
 &redirect_uri={redirect-uri}
 &code={code}
 &grant_type=authorization_code

서버에서 위의 링크로 'GET' 형식의 HTTP 요청(Request)을 해서, "액세스 토큰 (Access Token)" 데이터를 확인할 수 있습니다.

◼︎ 티스토리 액세스 토큰 간편 생성 서비스 활용하기

티스토리 액세스 토큰 간편 생성 서비스 (Tistory Access Token Generator)는 티스토리 API를 사용하기 위해 필요한 액세스 토큰 (Access Token)을 간편하게 발급 받을 수 있는 온라인 서비스입니다.

프로그래밍/코딩이 낯선 일반 사용자들은 "인증 코드(Authentication Code)" 및 "액세스 토큰(Access Token" 발급 과정이 어려울 수 있는데, 이럴 경우 티스토리 액세스 토큰 간편 생성 서비스 (Tistory Access Token Generator)를 통해 쉽고 빠르게 필요한 정보를 발급받을 수 있습니다.

(1) 인증 코드 (Code) 발급 받기

먼저 "인증 코드 발급 (Get Code)" 탭에서 "앱 아이디 (Client ID)", "콜백 URL (Redirect URI)" 정보를 입력한 뒤, 하단의 "코드(Code) 정보 확인" 버튼을 클릭합니다.

새로 열리는 창에서 "허가하기" 버튼을 클릭하면, 입력한 "콜백 URL (Redirect URI)"로 리디렉션(자동 이동)됩니다.

리디렉션(자동 이동)된 웹페이지의 주소(URL)에서 "code" 파라미터 값을 복사해서 보관해 둡니다. (예: https://xxxxx.xxxxxx.com/?code=XXXXXXXXXXXXX )

(2) 액세스 토큰 (Access Token) 발급 받기

티스토리 액세스 토큰 간편 생성 서비스 (Tistory Access Token Generator)로 다시 돌아 온 뒤, "액세스 토큰 발급 (Get Access Token)" 탭에서 기존의 "시크릿 키 (Client Key)"와 방금 발급 받은 "인증 코드 (Code)"를 입력합니다.