Notion API 시작하기 (2023.03 ver)

개요

노션은 다양한 기능과 마크 다운 지원 언어로 편리하게 문서 작업이 가능합니다. 또한 윈도우와 맥, 안드로이드와 IOS, 크롬, 사파리, 파이어폭스 익스텐션까지 지원하고 있어 어디서든 문서 작업을 편리하게 가능해 많은 개인과 기업들이 이용하고 있습니다.

이러한 노션에서 API를 제공하기 시작했습니다.

Notion Integrations는 Notion으로 할 수 있는 작업을 넓혀줍니다. Notion Integrations를 통해 프로그래밍 방식으로 Notion 데이터와 상호 작용할 수 있으므로 해당 데이터를 다른 도구에 연결하거나 Notion 내에서 워크플로를 자동화할 수 있습니다.

---

Intergration 종류

Internal Notion Integrations

하나의 특정 작업 공간에 연결되어 워크스페이스 내의 구성원만 사용할 수 있습니다. 따라서 해당 작업공간에 Integrations를 추가하려면 관리자 수준의 권한이 필요합니다.

Public Notion Integrations

일반적인 사용자를 위해 구축된 서비스로, 작업 공간에 모든 사용자들이 사용할 수 있도록 설정합니다. OAuth 2.0 프로토콜을 따라 여러 작업공간에 엑세스합니다.

이를 위해서 Redirection URI등 여러 사항들을 설정해줘야 합니다.

---

Intergration 생성하기

1. 우선 API 사이트에 접속해줍니다.

2. 상단 View My Intergrations 버튼을 눌러서 Integrations 편집 페이지로 이동합니다.

3. Create new Integrations을 눌러 신규 Integrations을 추가해주도록 합니다.

4. 기본적인 정보를 입력해줍니다.

Associated workspace의 경우 접속된 계정으로 생성된 workspace들을 연결해줍니다. 잘못 선택할 시 Integrations를 다시 생성해야 하니 다시 한번 확인해주세요.

---

Integration 수정

Integration생성은 끝났지만 Secrets Token값을 얻거나 public으로 type을 변경하고 싶다면 수정 페이지로 들어가야만 합니다.

Secrets

Internal workspace에서 사용할 토큰입니다. 토큰 값은 secret_… 으로 이루어져 있습니다.

Basic Information

1. Internal integrtion Type의 경우에는 Associated Workspace가 있던 자리에 Integration type이 생긴점 이외에는 달라지는 점이 없습니다.

2. Public Integration의 경우에는 항목이 추가되는데, 주로 조직이나 회사를 위한 항목들이 많이 보입니다. 또한 자동적으로 약관에 동의하게 됩니다.