Home [Notion API] integrations
Post
Cancel
Preview Image

[Notion API] integrations

노션 API의 시작은 통합 (integrations)이다.

통합을 생성하고, 원하는 노션 문서에 통합을 추가한 뒤, 해당 통합SECRET KEY를 통해서 Authorization하면 된다.

시작하기 전에

먼저 시작하기 전에 필요한 사항은 사용하려는 계정이 워크스페이스의 Admin 계정이어야 한다는 것이다.

만약 개인적으로 그냥 사용하려면 무료로 사용할 수 있기 때문에 아무런 문제가 없다.

Create a new workspace 글을 보고 필요하면 만들자.

통합 생성하기

통합을 생성하려면 https://www.notion.so/my-integrations에서 생성하면 된다.

처음 페이지에 들어가면 아래와 같은 화면이 보인다.

1.png

당연히 처음에는 아무것도 없으니 생성하러 가보자.

2.png

이제 이름과 연결할 워크스페이스를 설정해주면 된다. 설정하고 나면 아래와 같은 화면으로 넘어가게 된다.

3.png

기본적으로 integration의 경우에는 크게 2가지로 나뉜다.

internal integration 와, public integration 이다.

4.png

internal integration의 경우에는 관리자로 있는 워크스페이스이기 때문에 별다른 인증이 필요없고,

public integration의 경우에는 인증이 필요하다고 한다.

만약 internal integration인데 어드민이 아닌 경우 새롭게 생성하면 된다.

이제 다시 https://www.notion.so/my-integrations로 가보면 생성한 통합이 보인다.

5.png

Note

현재 통합은 삭제가 안된다. 필자도 테스트용으로 하나 더 만들어봤는데, 아직 링크에서 삭제하는 버튼도 없고, 관련된 슬랙에서 확인해봐도 아직 제공안하는 것으로 보인다. 나중에 추가되면 글도 수정해야지…

통합 사용 설정하기

이제 생성한 통합의 원하는 노션 문서에 사용 설정을 해주면 된다.

우선 아래와 같이 연습용 노션을 만들었다.

물론 노션을 만드는 워크스페이스는 통합에서 설정한 워크스페이스다.

그 다음, table을 인라인으로 하나 생성했다.

6.png

이제 테이블에 들어가서 아래와 같이 공유 설정을 통해서 워크스페이스 사용설정하면 된다.

7.png 8.png 9.png 10.png 11.png

이제 다음 글에서 API를 통해서 테이블에 글을 생성해보겠다.

References

This post is licensed under CC BY 4.0 by the author.

[Notion API] Notion API 정리

[Notion API] Authorization