API 연결 가이드

API가 무엇인가요?

-쉽게 말해서, API는 내 노션에 접근할 수 있는 열쇠예요. 위젯/웹페이지 등 외부 서비스가 내 노션에 접근하려면 1.열쇠가 있어야 하고(API 키) 2.그 열쇠로 어떤 방에 들어갈 수 있는지 정해야 해요(API 연결)

즉, 열쇠가 있다고 내 노션에 모두 접근할 수 있는 게 아니라, 내가 지정한 페이지에만 접근할 수 있어요. 아래는 열쇠를 만들고 접근 권한을 주는 과정입니다!

</aside>

1. 노션 API 토큰 발급받기

노션 API 토큰은 내 노션 DB에 접근하기 위한 열쇠입니다. 이 토큰은 비밀번호처럼 취급해 주세요.

흐름: 연결 만들기 → 토큰 복사 → 저장 — 이 3단계입니다.

Notion Developers 페이지에 접속합니다.
[연결] 탭에서 [+신규 연결] 을 눌러 주세요
연결 이름에는 원하는 이름을 적고 인증 방법은 액세스 토큰을 유지합니다.
설치 가능 워크스페이스에서 템플릿을 복제한 워크스페이스를 선택합니다. (보통 자동으로 선택되어 있습니다)
액세스 토큰 항목에서 눈 아이콘을 클릭하면 ntn~ 으로 시작하는 문자가 나타납니다. 복사 버튼을 눌러 이 토큰을 복사한 뒤에 다른 곳에 저장해 주세요!
사용자 기능 항목에서 사용자 정보 없음을 선택한 후에 우측 하단 연결 저장 버튼을 눌러 주시면 끝입니다.

<aside> 🔒

토큰은 절대 공개 페이지, 스크린샷 등을 그대로 올리지 마세요. 다른 사람이 토큰을 알면 연결된 DB를 읽거나 수정할 수 있습니다.

</aside>

API를 연결할 페이지에 들어가 주세요 (복제한 템플릿이나 연결할 DB가 있는 페이지)
- ex) PD FLOW 템플릿을 구매하셨다면, 템플릿의 메인 화면에서 연결해 주시면 됩니다. (그럼 템플릿 안의 하위 페이지, DB들에도 자동으로 권한이 부여돼요)