자동화 세팅하기
1. API등록
1) 개발자 페이지
노션 API를 등록하기 위해서는 먼저 노션 개발자 페이지(developers.notion.com)에 접속해야 합니다. 'View my integrations'를 클릭하여 새로운 통합(integration)을 시작할 수 있습니다.
2) API생성
통합 생성 시에는 통합의 이름을 지정하고, 원하는 경우 로고 이미지를 추가할 수 있으며, 어떤 워크스페이스와 연결할지 선택합니다. 그 다음 단계에서는 이 통합이 어떤 권한을 가질지 설정하게 됩니다. 페이지를 읽고 수정할 수 있는 권한과 접근할 수 있는 컨텐츠 유형을 선택할 수 있습니다. 저는 프라이빗 유형으로 선택하고 저장했습니다.
퍼블릭 옵션을 선택하면 누구나 접근 가능한 API 통합이 만들어집니다. 이는 공개 프로젝트나 오픈소스 애플리케이션을 개발할 때 유용하지만, 보안에 주의해야 합니다. 민감한 정보를 다루는 경우에는 프라이빗 옵션을 권장합니다.
3) 토큰생성
설정이 완료되면 Integration Token이 생성되는데, 이 토큰은 API 요청을 인증하는데 사용되므로 안전하게 보관해야 합니다. 이게 나중에 필요한 “API토큰”이 됩니다.
4) 페이지 연결
실제로 API를 사용하고자 하는 노션 페이지에서 우측 상단의 버튼을 클릭한 후 "연결"에서 방금 생성한 통합을 검색해서 추가하면 됩니다.
5) 페이지 ID
설정을 완료하면 외부에서 노션 페이지를 자동으로 관리하고 업데이트할 수 있게 됩니다. 이때 연동할 페이지의 URL이 필요하며 아래 이미지처럼 유니크한 패턴이 “페이지ID”가 됩니다.
6) 연동테스트
"API 토큰"과 "페이지 ID"가 필요합니다. 코드에 이 두 가지를 입력하고 호출하면 결과를 리스트 형태로 받아볼 수 있습니다. 이 구조를 이용해서 페이지의 구조를 확인하고 업데이트할 수 있죠. 이것이 노션 자동화의 첫 걸음이 됩니다.
