Notion API로 데이터베이스 불러오기

Notion API로 데이터베이스 불러오기

0. 공식 문서 링크

• 포스트의 내용이 제대로 동작하지 않으면 한번 공식 문서를 탐험해 보세요!

오늘은 노션 데이터베이스 목록을 불러오는 방법을 소개해 보겠습니다.
아직은 노션 API가 베타 버전이라 그런지, 관련 포스팅이 거의 없어 이번 기회에 정리해보고자 합니다!

# API 요청 형태

curl 'https://api.notion.com/v1/databases/"$데이터베이스 아이디"' \
  -H 'Authorization: Bearer '"$NOTION_API_KEY"'' \
  -H 'Notion-Version: 2021-05-13'

1. Notion API Key 발급받기

노션 공식 API의 키는 https://www.notion.so/my-integrations 에서 발급받을 수 있습니다.

아직 베타 버전이다 보니 심플한 모습인데요, [Internal Integration Token] 을 복사해 사용하시면 됩니다.
만약 다수의 불특정 인원이 노션 DB에 접근하길 원하신다면 하단의 [Public Integration] 옵션을 체크하시면 됩니다.

 

다만 저는 그다지 필요한 기능이 아니기도 했고, redirect_uri 관련 오류가 계속 출력되어 이번 글에서는 다루지 않겠습니다.
(혹시 공개 인증이 필요하신 분들은 이 링크 를 참조하시면 됩니다!)

2. 데이터베이스 아이디 가져오기

데이터베이스 아이디는 데이터베이스의 링크에서 얻을 수 있습니다.

링크를 복사하면 "https://www.notion.so/c17an/2a788bc8723247388470b7f8040c37bf?v=6fae8c6617c04f86ae82ecbbaf49a3d8" 형태의 URL을 얻을 수 있을텐데, [유저 아이디] 와 v= 로 시작하는 뷰 아이디 사이의 값이 바로 데이터베이스 아이디입니다.

3. 노션 버전 지정하기

2021년 6월 1일부터 추가된 속성으로, 모든 요청에는 노션의 버전을 명시해야 합니다. (패치노트)
버전은 "2021-05-11"과 "2021-05-13" 또는 중 하나이나, "2021-05-13" 을 사용하겠습니다.

4. 성공?

이제 API 콜을 시도해 보겠습니다.

그런데 주어진 대로 요청을 보내도 데이터를 불러오지 못하는 모습입니다.

원인은 아직 API가 데이터베이스에 접근할 수 있는 상태가 아니기 때문인데요, 사용하려는 데이터베이스에 들어가 [Share] 를 선택한 뒤, [Invite] 를 클릭해 발급받은 API 키들의 이름을 선택해줘야 합니다.

5. 결과

API와 연동까지 끝났다면 아래 그림처럼 초대 목록에 API 이름이 추가되며, 이제부터는 자유롭게 노션 페이지와 데이터베이스에 접근할 수 있게 됩니다! 😆