API 연결 추가와 관리

API 통합 추가와 관리 - 메인
이 글에서는

다른 소프트웨어의 API를 Notion에 연결하고, 워크스페이스 작업을 자동화하고, 다른 플랫폼의 서비스를 Notion에서 이용하세요 🤖


Notion API 통합을 통해 강력한 워크플로를 빌드할 수 있습니다. 개발자 허브에서 API 문서, 리소스, API 통합 관리 도구에 대해 자세히 알아보세요.

멤버는 설정과 멤버내 연결에서 워크스페이스에 연결을 추가할 수 있습니다. 워크스페이스 소유자는 설정과 멤버연결에서 워크스페이스에 연결을 추가할 수 있습니다. 추가된 연결을 더 많은 페이지에 추가할 수 있습니다.

API 연결의 사용 권한 시스템은 Notion 사용자의 공유 권한 설정과 비슷하게 작동합니다. 워크스페이스에서 연결을 사용하려는 경우, 해당 연결을 활성화하려는 페이지에서 연결을 추가해야 합니다.

  • 페이지로 이동하여 오른쪽 상단의 ••• 버튼을 선택하세요.

  • 팝업창 하단에서 연결 추가를 클릭하세요.

  • 팝업창이 나타나면 해당 페이지에 추가할 연결을 검색하고 선택하세요. 해당 워크스페이스에서 생성되고 연결된 연결만 옵션으로 나타납니다.

  • 이제 페이지의 ••• 메뉴에 연결 항목이 표시됩니다.

  • 페이지에서 연결을 제거하려면 항목 이름에 마우스 커서를 가져간 후 연결 해제를 클릭하세요.

참고: 워크스페이스에 생성된 모든 연결은 워크스페이스 소유자만 관리할 수 있고, 멤버는 본인이 생성한 연결만 사용할 수 있습니다.

  • 왼쪽 사이드바에서 설정과 멤버 > 연결 탭으로 이동하세요.

  • 멤버워크스페이스라는 두 개의 탭이 표시됩니다.

    • 멤버 탭에서는 멤버가 워크스페이스에서 액세스할 수 있는 API 통합 기능을 관리할 수 있습니다. 특히 승인된 API 통합 목록에 대한 API 통합 액세스를 제한하고, 내부 API 통합을 사용하는 사용자를 확인하고, 워크스페이스에서 API 통합 사용을 차단할 수 있습니다.

      • 참고: 엔터프라이즈 워크스페이스 소유자만 승인된 API 통합 목록에 대한 API 통합 액세스를 제한할 수 있습니다.

    • 워크스페이스 탭에서는 전체 엔터프라이즈 워크스페이스에 대한 보안과 규정 준수 관련 API 통합을 설치하고 관리할 수 있습니다.

  • 연결 옆의 ••• 아이콘을 클릭하면 아래와 같은 옵션을 볼 수 있습니다.

    • 프라이빗 API 토큰 검색

    • 개발자 웹사이트 방문 또는 개발자 지원팀에 문의

    • 연결 사용 권한이 있는 사용자 보기

    • 연결 해제

엔터프라이즈 요금제 워크스페이스를 사용 중인 경우, 워크스페이스 소유자는 워크스페이스의 API 연결을 관리하기 위한 추가 설정 옵션을 사용할 수 있습니다.

멤버의 연결 추가 제한

  • 워크스페이스 소유자 계정으로 설정과 멤버  연결 탭으로 이동하세요.

  • 멤버 탭 아래에는 멤버의 연결 추가 제한 옵션이 있습니다. 오른쪽의 드롭다운을 클릭하면 두 가지 옵션이 나타납니다.

    • 제한 없음: 모든 워크스페이스 멤버가 워크스페이스에 연결을 설치할 수 있게 됩니다.

    • 승인된 연결만 설치: 워크스페이스 멤버는 워크스페이스 소유자가 사전 승인한 연결만 설치할 수 있습니다. 워크스페이스 소유자가 아직 승인된 리스트에 없는 API 통합을 설치하는 경우 나중에 승인된 API 통합에 자동으로 추가됩니다.

Notion이 생성한 API 연결 자동 승인

승인된 연결 목록

  • + 승인된 API 연결 추가 버튼을 클릭해 워크스페이스의 멤버가 승인된 연결을 추가하도록 허용할 수 있습니다.

참고: 다른 워크스페이스 멤버들이 연결을 사용하도록 승인하기 전에 본인이나 다른 관리자가 먼저 연결을 설치해야 합니다. 워크스페이스에 이미 설치된 연결만 + 승인된 API 연결 드롭다운에 표시됩니다.

연결 설치에 대해서는 아래에서 자세히 알아보세요.

  • 승인된 API 연결 제목 아래에는 워크스페이스에서 승인되어 설치된 모든 연결 항목이 표시됩니다.

  • 각 연결 항목 오른쪽에 워크스페이스에서 연결을 설치한 사용자의 이름이 나타납니다.

  • ••• 메뉴를 클릭해 아래의 작업을 수행할 수 있습니다.

    • 사용자를 기준으로 필터링

    • 특정 사용자의 연결 사용 권한 철회

    • 모든 사용자 연결 해제

    • 승인된 연결 목록에서 제거

OAuth로 타사 플랫폼에서 직접 연결

Notion은 Zapier, Typeform 등의 서비스와 직접 파트너십을 체결했습니다. OAuth를 통해 Notion 파트너 서비스 사이트에서 공개 API 통합을 Notion 워크스페이스에 직접 연결할 수 있습니다.

  • 파트너 플랫폼의 앱 메뉴에서 Notion을 검색해 추가하세요.

  • Notion 워크스페이스에 대한 액세스를 요청하는 인증창이 나타나고, 연결에 필요한 액세스 수준이 표시됩니다.

  • 연결은 워크스페이스별로 적용됩니다. 필요한 경우 상단의 워크스페이스 이름을 클릭해 다른 워크스페이스로 전환하고 페이지 선택을 클릭하세요.

  • 이제 선택한 워크스페이스에 있는 모든 페이지의 목록이 표시됩니다. 해당 연결로 액세스하려는 페이지를 선택한 후 액세스 허용을 클릭하세요.

  • 인증을 완료하면 워크스페이스의 설정과 멤버연결에 해당 연결이 표시됩니다.

  • 연결 항목 옆의 ••• 아이콘을 클릭해 개발자 웹사이트를 방문하거나, 개발자 지원팀에 문의하거나, 워크스페이스에서 연결을 해제할 수 있습니다.

프라이빗 API 토큰으로 통합

일부 플랫폼의 경우 Notion 워크스페이스와 통합하기 위해 프라이빗 API 통합 토큰이 필요합니다.

  • 이 경우에는 아래의 안내에 따라 먼저 워크스페이스에 프라이빗 API 통합을 생성해 주세요.

  • 프라이빗 API 통합이 생성된 후 사이드바에서 설정과 멤버 > 연결 탭으로 이동하세요.

  • 파트너 플랫폼에 링크하려는 기존 연결을 찾아 이름 옆의 ••• 메뉴를 클릭하고 프라이빗 API 통합 토큰 복사를 클릭하세요.

  • 이 토큰을 파트너 플랫폼의 설정 양식에서 해당하는 필드에 붙여 넣으세요.

참고: Notion은 타사 API 통합에 대한 문제 해결을 지원하지 않습니다. 피드백과 질문은 해당 서비스 플랫폼의 지원 팀으로 문의해주세요.


피드백 보내기

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