조직 단위로 연동하기

조직 API 키는 조직 소속 워크스페이스 전체의 노트에 닿는 서버-투-서버 연동용 키예요. 인증과 웹훅이 동작하는 방식은 일반 API 키와 똑같고, 다른 점은 접근 범위뿐이에요.

조직 API 키와 조직 웹훅은 조직 관리자만 발급·등록할 수 있어요.

조직 API 키는 어디까지 닿나요?

조직 API 키는 조직에 소속된 워크스페이스에 들어 있는 노트에 닿아요. 조직 밖 개인 워크스페이스의 노트에는 닿지 않아요.

조직 API 키는 아래 엔드포인트로 조직과 워크스페이스, 노트를 조회해요.

엔드포인트	용도
`GET /v1/external/organizations/me`	키가 연결된 조직 확인
`GET /v1/external/workspaces`	조직 소속 워크스페이스 목록 (조직 키면 전체 반환)
`GET /v1/external/organizations/me/notes`	조직 소속 워크스페이스의 종료된 노트 목록 (`endedAfter`·`endedBefore`로 기간 한정, cursor 페이지네이션)
`GET /v1/external/notes/{noteGuid}`	개별 노트 메타데이터 조회

조직 키는 구성원 전체의 노트에 접근할 수 있으므로 보관과 접근 통제에 유의하세요. 유출이 의심되면 즉시 조직 콘솔에서 회수하고 재발급하세요. 키의 secret은 발급 시점에만 표시돼요.

API 키 종류별 접근 범위와 발급 방법

이벤트 구조, 재시도 정책, 검증 방법