찬찬의 Notion API 정복기 01 - Settings

The English series link is here.

안녕하세요 할말만 하고 사라지는 QA Specilist 찬찬의 노션 API 정복기 그 첫시간 입니다.
파이선으로 Notion API 세팅 및 활용 방법에 대해 기재해보려고 합니다.

Python Packages for Notion API

현재 Python으로 공개된 Notion API가 두가지가 있습니다.

• Unofficial Python 3 client for Notion.so API v3
  https://github.com/jamalex/notion-py
• notion-sdk-py is... client library for the official Notion API.
  https://github.com/ramnes/notion-sdk-py

여기서 저희가 활용하고자 하는 패키지는 official이라고 언급된 notion-sdk-py 입니다. unofficial 도 써봤는데... official 패키지 쓰시면 수월한게, Notion API Reference에 기술된 API 명 그대로 활용하면 되니까요.

파이선은 각자 편한 IDLE(Integrated Development Environment, 통합 개발환경) 저는 PyCharm 씁니다. JetBrains 빠돌이 라서

Python Package 설치

처음 설치를 해야될 Python Package가 the official Notion API, dotenv 두가지 입니다. dotenv는 노션 API 키를 안전하게 가져오기 위한 패키지입니다. PyCharm 쓰시는 분들은 하단 Python Packages에서 notion-client 검색 후 우측의 Install 을 눌러서 설치해주시면 되겠죠.

• pip install python-dotenv (※ 주의 : pip install dotenv가 아님)
• pip install notion-client

API Secret Key 생성하기

노션의 My Integrations 접속하시면 API 생성하는 메뉴가 있습니다.
1. 새 API 통합 만들기를 선택
2. 필수항목 기입후 생성
3. 생성된 API 항목 클릭
4. 시크릿 키가 생성된 것을 확인

이제 이 Secret Key를 dotenv 명령어로 환경변수에 보관후 안전하게 가져와서 쓰면 됩니다.

dotenv 설정하기

dotenv가 제대로 설치 되었다면 dotenv 실행이 가능할겁니다.

이제 Secret Key를 저장해보겠습니다.
실행은 파이선이 실행되는 Directory에서 하시면 됩니다.

• dotenv set NOTION_TOKEN secret_xxxxxxxx
  secret_xxxxxxx 에는 생성한 API의 Secret Key를 기입합니다.
• dotenv list
  위 명령어로 제대로 Secret Key가 입력되었는지 확인

Python에서 Notion Secret Key 가져오기

다음과 같은 명령어로 패키지를 가져옵니다.
그런 뒤 notion_client 를 객체형태로 가져오시면 Python 으로 노션 사용할 준비가 완료됩니다.

from dotenv import dotenv_values
from notion_client import Client

config = dotenv_values(".env")
notion_secret = config.get('NOTION_TOKEN')
notion = Client(auth=notion_secret)