새롭게 단장한 고객센터에 방문해주셔서 감사합니다. 중요한 도움말은 대부분 번역을 완료했지만, 아직 번역되지 않은 도움말이 남아있어요. 곧 모두 번역을 완료할 예정이니 불편하시더라도 조금만 기다려주시면 감사하겠습니다! 당분간은 이전 버전의 도움말과 지원 페이지도 참고해주세요.

API 통합 추가와 관리

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

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


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

참고: 워크스페이스의 멤버와 관리자 모두 설정과 멤버 > API 통합 탭에서 워크스페이스에 API 통합을 생성하고 관리할 수 있습니다.

기업 요금제 워크스페이스의 경우 관리자만 통합을 생성, 관리하도록 제한할 수 있습니다.

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

  • API 통합 탭에서는 이 워크스페이스에 설치된 모든 API 통합, 통합을 추가한 관리자, 추가된 날짜 정보를 확인할 수 있습니다.

  • 추가 옵션을 보려면 통합 항목 옆의 ••• 아이콘을 클릭하세요.

    • 해당 API 통합의 토큰 검색(프라이빗 API만 해당)

    • API 개발자 웹사이트 방문 또는 지원팀에 문의(오픈 API만 해당)

    • API 통합 해제

기업 요금제 워크스페이스를 사용 중인 경우, 관리자는 워크스페이스 API 통합 관리를 위해 추가적인 설정 옵션을 사용할 수 있습니다.

멤버의 API 통합 생성 제한

  • 관리자 계정으로 설정과 멤버 > API 통합 탭으로 이동하세요.

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

    • 끄기: 제한을 끄면 모든 워크스페이스 멤버가 워크스페이스에 통합을 설치할 수 있습니다.

    • 승인된 API 통합만 설치 가능: 워크스페이스 멤버는 관리자가 사전 승인한 통합만 설치할 수 있습니다.

Notion이 생성한 API 통합 자동 승인

  • 승인된 API 통합만 설치 가능 옵션을 선택할 경우, 관리자는 Notion에서 생성한 API 통합을 자동 승인할지 결정할 수 있습니다. 아래는 자동 승인이 가능한 앱의 예시입니다.

    • GitHub

    • Jira

    • Slack

    • Asana

    • Trello

승인된 API 통합 목록

  • + 승인된 API 통합 추가 버튼을 클릭해 워크스페이스 멤버가 승인된 API 통합을 추가할 수 있도록 허용하세요.

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

API 통합 설치에 대한 지침은 아래에 자세히 나와 있습니다.

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

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

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

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

    • 특정 사용자의 API 통합 권한 철회

    • 모든 사용자 연결 해제

    • 승인된 API 통합 목록에서 제거

OAuth로 타사 플랫폼에서 직접 통합

Notion은 Zapier, Typeform, Automate.io 등의 몇몇 플랫폼과 직접 파트너십을 체결했습니다. OAuth를 통해 Notion 파트너 플랫폼에서 오픈 API를 바로 Notion 워크스페이스에 통합해 보세요.

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

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

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

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

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

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

팁: API 통합의 실제 예시를 몇 가지 보고 싶으시다고요? 이 가이드를 참고해 주세요 →

프라이빗 API 토큰으로 통합

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

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

  • 프라이빗 API 통합이 생성된 후 설정과 멤버 > API 통합 탭으로 이동하세요.

  • 외부 플랫폼과 연결하려는 프라이빗 통합 항목을 찾아 ••• 메뉴를 클릭하고 프라이빗 API 통합 토큰 복사를 클릭하세요.

  • 이 토큰을 외부 플랫폼의 설정 양식에서 관련 필드에 붙여 넣으면 프라이빗 API 통합으로 해당 플랫폼의 서비스를 연결해 사용할 수 있게 됩니다.

참고: 타사 API 통합 문제 해결

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

API 통합 시 Notion 사용자의 사용 권한은 공유 권한 과 비슷하게 적용됩니다. 워크스페이스에서 API 통합을 하려는 경우, 해당 API로 서비스를 사용하려는 페이지에서 통합을 추가해야 합니다.

참고: 워크스페이스의 멤버와 관리자 모두 설정과 멤버 > API 통합 탭에서 워크스페이스에 API 통합을 생성하고 관리할 수 있습니다.

기업 요금제 워크스페이스의 경우 관리자만 통합을 생성, 관리하도록 제한할 수 있습니다.

  • 해당 페이지로 이동하고 오른쪽 상단의 공유 버튼을 클릭하세요.

  • 이메일, 사용자, API 통합 등을 추가하세요라고 되어있는 부분을 클릭하세요.

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

  • 이제 페이지의 공유 메뉴에 통합 항목이 표시됩니다.

  • API 통합에 콘텐츠에 대한 세부적인 권한 수준이 설정되어 있다면, 사용 권한이 복합 사용 권한으로 표시됩니다. 복합 사용 권한 버튼을 클릭하면 해당 페이지에서 API 통합에 적용된 정확한 권한이 표시됩니다.

  • 페이지에서 통합을 제거하려면 통합 항목 옆에 있는 드롭다운을 클릭한 후 제거를 클릭하세요.


피드백 보내기

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


다음 글

Notion API로 통합 생성

Notion의 API를 사용하여 원하는 대로 프라이빗 API 통합을 생성할 수 있습니다. 일부 플랫폼의 경우 플랫폼을 Notion 워크스페이스에 연결하기 위해 프라이빗 API 통합 토큰이 필요할 수 있습니다. 아래에서 토큰과 관련된 내용을 자세히 설명해 드릴게요 🏗