Notion API 연결

Notion에서 개인 사용 권한 토큰을 관리할 수 있습니다. 설정에서 개발자 모드를 켠 다음, 사이드바의 개발자 섹션에서 개인 사용 권한 토큰을 열어보세요. 문서, 리소스 및 연결 관리 도구는 개발자 허브에서 확인할 수 있습니다.

관리자 토큰을 찾으시나요? 이 페이지의 토큰은 하나의 워크스페이스 내에서 작동하며 페이지 콘텐츠를 처리합니다. 내보내기, 증거보존 조치, 또는 사용자를 로그아웃시키는 등의 조직 관리자 업무를 실행해야 할 경우 엔터프라이즈 조직을 위한 관리자 API를 참조하세요.

1. 왼쪽 사이드바에서 설정을 선택한 다음 연결탭으로 이동하세요.

2. 워크스페이스 소유자만 연결 탭에 접근하고 통합을 생성할 수 있습니다. 관리자가 아닌 경우 워크스페이스 관리자에게 문의하거나 다른 워크스페이스를 사용하세요.

3. 개발자 모드를 켠 다음, 사이드바의 개발자 섹션에서 개인 사용 권한 토큰을 열어보세요.

4. + 새로 만들기 연결을 클릭하세요.

5. 연결 이름을 지정하세요. 원하는 경우 이미지를 업로드하여 로고로 사용할 수도 있습니다.

6. 드롭다운 메뉴에서 해당 연결을 사용하고자 하는 연결된 워크스페이스 를 지정하세요.

   

   참고: 데스크톱에서 사용한 계정과 동일한 계정으로 웹에서 Notion에 로그인해야 합니다. 그렇지 않으면 올바른 계정과 워크스페이스가 표시되지 않습니다.

   

7. 내부 연결이 성공적으로 추가되었습니다! 이제 워크스페이스의 설정 메뉴 → 연결에서 확인할 수 있습니다.

8. 내부 연결 토큰을 가져오려면 해당 내부 연결 옆의 •••을 클릭하세요. 이 토큰은 팀에서 생성하는 API 기반 자동화나 워크플로, 또는 워크스페이스를 일부 파트너 플랫폼에 링크할 때 필요합니다.

새로 추가되는 연결은 처음에는 내부 연결로 설정됩니다. 공용 연결을 개발하는 개발자라면, 위의 안내에 따라 먼저 내부 연결을 생성하세요.

그 다음, 개발자 가이드 의 설명에 따라 공개 연결로 전환할 수 있습니다.

API 통합을 설정하는 과정에서 사용자의 사용 권한을 지정할 수 있습니다.

• 콘텐츠 관련 권한

  • 콘텐츠 읽기만 허용

  • 콘텐츠 쓰기만 허용

  • 콘텐츠 입력 허용

• 사용자 관련 권한

  • 사용자 정보에 접근 불가

  • 사용자 정보 읽기 허용(이메일 주소 제외)

  • 사용자 정보 읽기 허용(이메일 포함)

사용자가 연결을 설치하면 이 사용 권한 수준이 표시됩니다. 또한, 연결이 추가된 페이지의 공유 메뉴에도 표시됩니다. 워크스페이스에 연결을 설치하는 방법 자세히 알아보기 →

연결 웹훅을 사용하면 연결을 통해 Notion 워크스페이스의 변경 사항을 실시간으로 모니터링하고 대응할 수 있습니다.

연결과 공유되는 페이지 또는 데이터베이스에 변경 사항이 발생하면 Notion은 웹훅 엔드포인트에 알림을 자동으로 전송하여 연결이 다른 도구를 즉시 업데이트하거나 자동화된 작업을 실행하거나 최신 변경 사항을 표시할 수 있도록 합니다.

자세한 방법은 개발자 문서를 참고하세요.

웹훅 작업과 연결 웹훅은 트리거를 가지고 있고 타사 서비스로 이벤트를 보낼 수 있다는 점에서 유사합니다. 하지만 연결 웹훅은 더 폭넓은 기능을 제공합니다.

• 여러 워크스페이스에서 활동을 모니터링할 수 있습니다.

• 개수 제한 없이 작업을 처리할 수 있습니다.

이와 반대로 웹훅 작업은 보다 간단한 사용 사례를 위해 설계되었으며 제한된 트리거 세트를 가진 데이터베이스 자동화를 통해 구성됩니다.