노션API 사용방법 - 1. 조작하기위한 준비 (Integration, Token)

노션api 가 상용된지 좀 되었으나 노션공식문서보고 직접 시행착오를 겪어보면서 정리해보았다.

 

1. Notion Integration 생성하는 방법 (토큰)

노션api를 사용하려면 노션 로그인된 상태로 노션개발자페이지로 이동하여 Integration을 생성해 토큰을 받아야한다.

 

 

  a.  노션에 로그인된 상태로 여기 (https://developers.notion.com)로 접속한다.

 

  b.   View my integrations  을 클릭한다.

 

 

  c.  왼쪽의  New integration 이나 가운데의   View Create new integration  을 클릭한다.

 

 

 

  d.  본인에게 맞게 설정하여  Submit  눌러서 생성한다.

 

 

Name 을 입력하고 사용할 내 노션이 맞는지 Associated workspace 에서 확인해주자. 다른 것들은 설정안해도 무관하지만, integration에게 어떤 일을 가능하게 할 건지 Capabilities 쪽을 설정할 수 있다.

 

• Read content 는 읽기전용,
• Update content 는 이미 있는 페이지나 database 를 수정만,
• Insert content 는 페이지를 생성하는 것을 의미한다.

 

필요하다면, Read comments 를 체크하여 페이지에 달린 댓글을 가져올 수 있고, Insert comments를 체크하여 댓글이 달리도록 허용할 수 있다.  * 나중에도 수정할 수 있다.

 

 

  e.  정상적으로 생성되면 생성한 내 intergration 페이지로 이동되는데 여기에서 Show누르고Copy도 눌러서 토큰을 저장해두자.

 

 

  f.  이제, 이 Intergration이 쓰일 노션 페이지(데이터베이스 전체페이지)로 이동하여 더 보기(점 3개) 누르고  Submit+ Add connections (연결 추가)  를 눌러 생성한 Integration을 선택해주면 된다.

 

 

 

---

데이터베이스 전체페이지 이어야 API로 작동이 되니 한번 더 확인해주자!