Notion API 연결

이 참조 문서에 있는 내용

Notion API를 사용하면 맞춤형 내부 연결을 만들 수 있어요. 일부 파트너 플랫폼을 Notion 워크스페이스에 연결하려면 API 토큰이 필요할 수도 있어요. 아래에서 설정 방법을 단계별로 안내해 드릴게요.


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

참고: 각 연결에는 소유자가 한 명 이상 있으며, 소유자는 모두 연결을 관리하고 API 토큰을 가져올 수 있어요. 연결을 생성할 수 있는 사람은 요금제와 워크스페이스 설정에 따라 달라요. 엔터프라이즈 연결 설정 →에 대해 자세히 알아보세요.

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

어떤 토큰이 필요한가요? Notion에서는 여러 종류의 토큰을 사용해요. 내부 연결에서 복사하는 토큰은 이 문서에서 다루는 API 토큰이에요. 개인 액세스 토큰은 내 계정에 연결돼 있어요. OAuth는 로그인해서 사용하는 앱의 인증을 처리해요. 파트너 플랫폼에서 내가 만든 연결의 토큰을 요청하면 API 토큰을 사용하세요.

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

  2. 연결을 만들 수 있는 사람은 워크스페이스에 따라 달라요. 무료 요금제와 플러스 요금제에서는 워크스페이스 소유자만 연결을 만들 수 있어요. 비즈니스 요금제와 엔터프라이즈 요금제에서는 워크스페이스 소유자가 멤버나 특정 그룹의 멤버에게도 연결 생성 권한을 부여할 수 있어요. 연결을 만들 수 없다면 워크스페이스 소유자에게 문의하세요.

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

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

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

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

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

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

  8. 내부 연결 옆의 •••을 클릭해 API 토큰을 복사하세요. 팀에서 만드는 API 기반 자동화나 워크플로에 이 토큰이 필요해요. 일부 파트너 플랫폼에 워크스페이스를 연결할 때도 사용해요.

API 통합 정보

참고: 내부 연결은 워크스페이스별로 적용됩니다. 따라서 연결할 워크스페이스를 변경하기 위해서는 새 연결을 생성해야 합니다.

API 통합 메뉴 - API 통합 생성

모든 내부 연결에는 최소 한 명의 소유자가 있어요. 소유자는 연결 설정을 변경하고 API 토큰을 가져올 수 있어요. 소유권을 공유하면 여러 사람이 같은 연결을 관리할 수 있어요. 그러면 누군가 역할이 바뀌거나 워크스페이스를 떠나더라도 업무가 중단되지 않아요.

소유자를 추가하거나 제거하려면:

  1. 개발자 포털을 열고 연결을 선택하세요.

  2. 연결 소유자 탭을 여세요.

  3. 멤버나 그룹을 소유자로 추가하거나 제거하세요.

연결 소유자에 대해 다음 사항을 참고하세요.

  • 전체 멤버와 워크스페이스 소유자만 연결 소유자가 될 수 있어요. 게스트와 사용 권한이 제한된 멤버는 소유자가 될 수 없어요.

  • 소유자로 추가할 수 있는 사람은 워크스페이스의 연결 생성 권한 설정에 따라 달라요.

  • 연결에는 항상 최소 한 명의 소유자가 있어야 하므로 마지막 소유자는 제거할 수 없어요.

  • 워크스페이스 소유자로서 연결의 관리를 넘겨받아야 한다면 먼저 자신을 소유자로 추가하세요.

  • 마지막 소유자가 워크스페이스를 떠나면 해당 연결의 API 토큰은 즉시 작동하지 않아요.

플러스, 비즈니스, 엔터프라이즈 요금제에서는 브라우저나 데스크톱 앱에서 Notion을 사용해 소유권을 공유할 수 있습니다.

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

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

공용 연결을 만들 때 누가 설치할 수 있는지 선택해요:

  • 모든 워크스페이스: 누구나 자신의 Notion 워크스페이스에 연결을 설치할 수 있어요.

  • 선택한 워크스페이스: 리스트에 추가한 워크스페이스에만 연결을 설치할 수 있어요.

자사만을 위한 기능을 만들고 다른 조직에서 설치하지 못하게 하려면 선택한 워크스페이스를 선택하세요.

누군가 연결을 설치할 때마다 Notion이 이를 확인해요. 해당 워크스페이스가 리스트에 없으면 설치가 중단되고 오류가 표시돼요.

연결 갤러리에는 누구나 설치할 수 있는 연결만 표시돼요. 선택한 워크스페이스로 제한된 연결은 갤러리에 표시되지 않아요.

참고: 연결을 만들 때 이 설정을 선택해요. 나중에 다른 설정이 필요한 경우 새 연결을 만드세요.

본인이 소유한 연결은 설치가 허용된 워크스페이스, 이미 설치된 워크스페이스, 또는 연결을 빌드한 워크스페이스 각각의 개발자 포털에 표시돼요.

모든 공용 연결에는 연결을 빌드하고 테스트하는 워크스페이스가 하나씩 있어요. 처음부터 다시 시작하지 않고도 다른 워크스페이스로 전환할 수 있어요.

  1. 개발자 포털에서 연결을 여세요.

  2. 연결 설정으로 이동하세요.

  3. 빌드할 워크스페이스를 선택하세요.

Notion이 해당 연결을 선택한 워크스페이스에 연결해요. 새 연결을 만들 필요는 없어요.

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

  • 콘텐츠 관련 권한

    • 콘텐츠 읽기만 허용

    • 콘텐츠 쓰기만 허용

    • 콘텐츠 입력 허용

  • 사용자 관련 권한

    • 사용자 정보에 접근 불가

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

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

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

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

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

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

현재 연결 웹훅은 다음에 대한 알림을 지원하지 않습니다.

  • 사용자 변경(워크스페이스 멤버십 변경, 이메일/이름 업데이트, 권한 수정 포함)

  • 워크스페이스 및 팀스페이스 설정 변경

이러한 유형의 알림의 경우 감사 로그를 사용하세요.

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

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

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

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


피드백 보내기

이 내용이 도움이 되었나요?


Powered by Fruition