무료 데이터베이스 - Notion Database Table API 설정하기

Notion의 Data Table에 저장된 정보를 외부에서 Notion API를 사용해서 Database처럼 사용할 수 있다. Notion API를 설정하고 사용하는 방법을 알아보자.

Data 개념 정리

🔗 Working with databases

Page는 데이터베이스 내의 항목으로 사용되며, 각 페이지의 속성은 상위 데이터베이스의 스키마를 따라야 한다. 즉, 데이터베이스를 표로 보는 경우 페이지의 등록 정보는 단일 행의 모든 값을 정의한다.

create a page API 끝점을 사용하여 페이지를 데이터베이스에 추가한다. 위의 예제 데이터베이스에 페이지를 추가한다. 끝점에는 '부모'와 '속성'의 두 가지 필수 매개 변수가 있다.

데이터베이스에 페이지를 추가할 때 parent 파라미터는 database parent이어야 합니다. 위의 예제 데이터베이스에 대해 이 개체를 작성할 수 있다.

 

Notion API 설정

1. Database 생성
2. Integration 생성
3. Integration에 Database 공유 설정

 

사용 전 준비사항

• Notion account에 로그인해서 Workspace를 준비한다.
• Admin level의 권한을 갖고 있어야 한다.
• Create at least one database in the workspace
• Install npm and node,js to use Notion’s JavaScript library → Flutter 사용할 예정이니 ❌

 

Database 생성

우선 API로 사용할 데이터베이스 테이블을 준비한다.

• Database로 사용할 테이블을 Database - Full Page(전체 페이지)로 생성한다.
• Sub Item 기능도 테스트를 하기 위해 설정한다.
• Linked Data도 설정해서 확인해보자.

Link로 연결된 두 데이터 테이블 생성

⚠️ 단, Linked Database는 API에서 지원하지 않는다.

Linked Database를 사용하고 싶다면, 약간의 편법적인 방법으로 타이틀 값 정도는 사용할 수 있는 방법을 찾았다.

 

Integration 생성

📎 https://developers.notion.com/docs/create-a-notion-integration

My Integrations에 접속해서 New Integraion 버튼을 클릭한다.

💡Public vs Internal
쉽게 생각하자면 나 또는 우리만 사용할 것인가, 아니면 내가 모르는 누구든지 사용할 수 있게 할 것인가이다.
Notion의 모든 사용자가 모든 Workspace에서 사용 가능하게 하려면 Public으로 설정하고, 본인만 사용할 계획이라면 Internal로 설정한다.

나 혼자 사용할 목적이므로 Internal 기본으로 생성한다. 기본 정보를 입력하고 Submit~!

• Associated workspace : 본인의 Notion이 맞는 지 확인한다. 다른 사람이나 팀과 공유된 Notion이 있는 경우 특히 주의!
• Name : 원하는 이름을 자유롭게 설정한다.
• Logo : 없어서 패스~

생성이 되면 바로 API Key인 Token을 확인할 수 있다. Show를 누르면 키가 나타나고 Copy를 눌러 복사할 수 있다.

 

Integration에 Database 공유 설정

• API로 사용할 데이터 베이스가 있는 페이지로 이동한다.
• 우측 상단의 ··· 메뉴를 클릭 → Add Connectins → 만들어둔 Integration을 선택한다.

확인을 요청하면 Confirm을 눌러 완료한다.

연결이 잘 되었다면 Connectons에 연결된 Integration이 추가된 것을 볼 수 있다.

이제 Notion Database를 API로 사용할 준비는 끝났다. 다음 포스팅에서 API를 호출하는 방법을 알아보기로 한다.