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

Notion API로 통합 생성

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

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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • 콘텐츠 관련 권한

    • 콘텐츠 읽기만 허용

    • 콘텐츠 쓰기만 허용

    • 콘텐츠 입력 허용

  • 사용자 관련 권한

    • 사용자 정보에 접근 불가

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

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

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


피드백 보내기

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