티스토리 포스팅 자동화를 위해 티스토리에서 제공하는 Open API를 사용해야 한다.
그리고 이 API 사용을 위해서는 access key를 1회 받아야 한다.
이 발급 과정을 정리한다.
<글 순서> 1. 티스토리 앱 등록 2. 인증 요청 3. Access Token 발급 받기 4. 글 목록 API 호출로 동작확인 |
<참고> 티스토리 Open API 공식 문서
https://tistory.github.io/document-tistory-apis/
공식 문서임에도 불구하고 기재가 굉장히 불친절하며 용어 사용이 일정하지도 않아 아주 헷갈린다. 나중에 심화하여 활용하고 싶을 때에 시간을 갖고 보면 좋겠다.
1. 티스토리 앱 등록
https://www.tistory.com/guide/api/manage/register
링크로 접속하여 본인 블로그로 접속을 위한 정보를 입력한다. 대부분 임의값 입력으로 문제 없으며 다음 항목들만 주의한다.
- 서비스 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 요청 및 응답 처리를 확인할 수 있는 다른 어떤 프로그램을 사용해도 상관없다.
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를 사용할 준비가 완료 되었다는 의미이며,
이제 파이썬을 활용하여 자동화 또한 가능하다는 의미가 되겠다.
앞으로는 파이썬을 활용한 글 쓰기 자동화 프로그램을 하나씩 구축해 보고자 한다.
'프로그래밍' 카테고리의 다른 글
[html/css] 마우스 휠 스크롤 애니메이션 만들기 (0) | 2022.09.23 |
---|---|
[Javascript] (번역 및 요약) ECMAScript 6 - ECMAScript 2015 (0) | 2020.08.06 |
[Javascript] 키 코드 값 간단히 찾기 (0) | 2020.08.05 |