API 연결 추가와 관리

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

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


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

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

기업 요금제의 경우, 워크스페이스 소유자만 연결을 생성하도록 제한할 수 있습니다.

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

  • 여기에서 이 워크스페이스에 생성된 모든 연결과 각각의 연결을 추가한 워크스페이스 소유자, 연결을 추가한 날짜 정보를 확인할 수 있습니다.

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

    • 프라이빗 API 토큰 검색

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

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

    • 연결 해제

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

멤버의 연결 추가 제한

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

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

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

    • 승인된 연결만 설치 가능: 워크스페이스 멤버는 워크스페이스 소유자가 사전 승인한 연결만 설치할 수 있습니다.

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

  • 승인된 연결만 설치 옵션을 선택할 경우, 워크스페이스 소유자는 Notion에서 생성한 연결을 자동 승인할지 결정할 수 있습니다. 아래의 툴은 자동 승인이 가능합니다.

    • GitHub

    • Jira

    • Slack

    • Asana

    • Trello

승인된 연결 목록

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

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

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

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

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

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

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

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

    • 모든 사용자 연결 해제

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

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

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

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

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

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

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

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

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

프라이빗 API 토큰으로 통합

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

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

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

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

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

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

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

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

기업 요금제의 경우, 워크스페이스 소유자만 연결을 생성하도록 제한할 수 있습니다.

  • 원하는 페이지로 이동하고 오른쪽 상단의 ••• 버튼을 클릭하세요.

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

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

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

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


피드백 보내기

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