티스토리 Open API 사용을 위한 access key 발급하기

티스토리 포스팅 자동화를 위해 티스토리에서 제공하는 Open API를 사용해야 한다.

그리고 이 API 사용을 위해서는 access key를 1회 받아야 한다.

이 발급 과정을 정리한다.

 

<글 순서> 1. 티스토리 앱 등록 2. 인증 요청 3. Access Token 발급 받기 4. 글 목록 API 호출로 동작확인

 

---

<참고> 티스토리 Open API 공식 문서

https://tistory.github.io/document-tistory-apis/

소개 · GitBook

공식 문서임에도 불구하고 기재가 굉장히 불친절하며 용어 사용이 일정하지도 않아 아주 헷갈린다. 나중에 심화하여 활용하고 싶을 때에 시간을 갖고 보면 좋겠다.

---

1. 티스토리 앱 등록

https://www.tistory.com/guide/api/manage/register

TISTORY

링크로 접속하여 본인 블로그로 접속을 위한 정보를 입력한다.  대부분 임의값 입력으로 문제 없으며 다음 항목들만 주의한다.

• 서비스 URL: 본인의 티스토리 도메인 (예: https://[본인 블로그 이름].tistory.com)
• 서비스 권한: 읽기, 쓰기 (당연히 읽기 권한만 있다면 포스팅을 쓸 수가 없다.)
• Callback: 정보를 돌려받을 위한 url을 입력해야하는 부분으로 무엇을 입력해도 크게 중요하지는 않지만 원활한 진행을 위해 여기처럼 https://tistory.com을 입력한다.

양식을 모두 작성했다면 등록 버튼을 누른다. 이후 동일 페이지의 [앱 관리] 탭에서 등록 결과를 확인할 수 있다.

방금 등록한 앱의 "인증관리 > 설정"을 누르면 App ID와 Secret Key가 발급되어 있다.

이 창은 닫지 말고 다음을 계속 진행하도록 한다.

 

 

2. 인증 요청 하기

메모장을 열고 다음을 복사하여 붙여넣는다. 그리고 각각의 {} 부분의 값들을 수정한다.

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

• {client-id} 1번 단계를 실행하여 얻은 결과 중 "App ID" 값
• {redirect-uri} https://tistory.com

위 둘을 수정했다면 브라우저를 열어서 완성된 url로 이동한다. 그리고 표시된 화면에서 "허가하기"를 클릭한다.

그 후 티스토리 메인 페이지로 이동되며, 여기서 주소표시줄 전체를 다시 복사하여 메모장으로 가져온다.

https://www.tistory.com/?code={code가 기재되는 부분}&state=

여기서 필요한 부분은 붉은 글씨 부분의 code 파라미터의 값이다. 이 값은 다시 다음 단계에 필요하니 메모해둔다.

3. Access token 발급 받기

지금부터는 편의를 위해 Postman이라는 프로그램을 사용하고자 한다. 편리하게 API 서버를 통한 요청-응답 확인을 위해 이용한다. 혹시나 다운로드 방법이나 사용법에 관한 정보가 필요하다면 참고할 수 있는 포스팅이 있다.

 

2020.09.18 - [프로그래밍/개발환경] - 포스트맨(Postman) 사용법과 API 실행해 보기

포스트맨(Postman) 사용법과 API 실행해 보기

 

Postman 외에 API 요청 및 응답 처리를 확인할 수 있는 다른 어떤 프로그램을 사용해도 상관없다.

 

Access Token 발급을 위해 실행해야할 API 정보는 다음과 같다.

Method	GET
URI	https://www.tistory.com/oauth/access_token
파라미터 정보	client_secret	App ID (1번 단계에서 발급 받은 값)
	redirect_uri	임의 사이트 주소 (https://tistory.com 입력으로 문제없음)
	code	code (직전 단계에서 발급 받은 code 값)
	grant_type	authorization_code (고정값)

API 메소드와 모든 URI + 파라미터 정보를 세팅 후, 요청을 실행하면 다음과 같이 access_token 값을 리턴해 준다.

만약, 리턴된 값이 위와 같지 않고 error를 리턴하는 등의 경우에는 실행한 API 정보에 문제가 있다는 의미이니 다시 한 번 확인하여 실행하도록 해야한다. (대부분의 경우 파라미터를 잘 못 설정하여 에러가 발생함)

 

 

4. 글 목록 API 호출로 동작 확인

access_token 값을 얻어왔으니 이제 본인의 티스토리 글 목록을 호출하거나 글을 작성하는 등 API를 이용한 조작이 가능해진다. 여기서는 확인 방법으로 글 목록 조회 API를 실행한다.

Method	GET
URI	https://www.tistory.com/apis/post/list
파라미터 정보	access_token	직전 단계에서 발급받은 access_token 값
	blogName	본인의 블로그명 (https://{블로그명}.tistory.com)

이 정보로 세팅하여 API를 실행하면 내 블로그에 쓰인 글들의 정보가 리턴된다.

현재는 "글 목록" 가져오기 API를 실행한 것이며, 앞으로 본인이 어떤 API를 실행해야 할 것인지,

어떤 종류의 API들이 있는지에 관해서는 글 초반에 첨부한 공식 문서 링크를 통해 확인해야 한다.

 

👍

문제 없이 리턴된 값을 확인했다면 티스토리 Open API를 사용할 준비가 완료 되었다는 의미이며,

이제 파이썬을 활용하여 자동화 또한 가능하다는 의미가 되겠다.

앞으로는 파이썬을 활용한 글 쓰기 자동화 프로그램을 하나씩 구축해 보고자 한다.