Notion API 통합

Notion API로 통합 생성 - 메인
이 글에서는

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


개발자 허브에서 API 문서, 리소스, 통합 관리 도구에 대해 자세히 알아보세요.

참고: 워크스페이스의 모든 연결은 워크스페이스 소유자가 관리할 수 있습니다. 자세한 내용을 보려면 여기를 클릭하세요.

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

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

  3. 하단에서 내 API 통합 개발하기 링크를 클릭하세요.

  4. 브라우저에서 내 API 통합이 열립니다. + 새 API 통합 버튼을 클릭하세요.

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

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

  6. 드롭다운 메뉴에서 해당 API를 통합할 연결할 워크스페이스를 지정하세요.

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

  7. 이 단계를 마치면 프라이빗 API 통합이 성공적으로 추가됩니다. 이제 워크스페이스의 설정과 멤버 > 내 API 통합탭에서 해당 통합 항목을 볼 수 있습니다.

  8. 프라이빗 API 통합 토큰을 검색하려면 해당하는 통합 항목 옆의 ••• 아이콘을 클릭하세요. 토큰은 API 기반의 자동화 체계나 워크플로를 구축하는 데 사용됩니다. 물론, 워크스페이스에 외부 플랫폼 서비스를 연결할때도 필요합니다.

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

새로 추가되는 API 통합은 처음에는 프라이빗 통합으로 설정됩니다. 오픈 API 통합을 사용하려는 개발자라면, 위의 안내에 따라 프라이빗 API 통합을 먼저 생성하세요.

그 다음, 개발자 가이드의 설명에 따라 오픈 API 통합으로 전환할 수 있습니다.

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

  • 콘텐츠 관련 권한

    • 콘텐츠 읽기만 허용

    • 콘텐츠 쓰기만 허용

    • 콘텐츠 입력 허용

  • 사용자 관련 권한

    • 사용자 정보에 접근 불가

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

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

API 통합을 설치할 때 사용 권한이 표시됩니다. 또한, API 통합이 추가된 페이지의 공유 메뉴에도 같은 내용이 표시됩니다. 워크스페이스에 API 통합을 설치하는 방법 자세히 알아보기 →


피드백 보내기

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