Base URL
모든 API 요청은 다음 주소로 보내세요.자격 증명별 워크스페이스 접근 범위
계정 API Key는 사용자 신원으로 동작하며, 그 사용자가 현재 접근할 수 있는 모든 워크스페이스의 리소스에 사용자와 같은 권한으로 접근해요. 워크스페이스 API Key는 연결된 워크스페이스 하나, 조직 API Key는 조직에 속한 워크스페이스에 한정돼요.GET /v1/external/workspaces를 호출하면 현재 자격 증명이 접근할 수 있는 워크스페이스 목록을 받아요. 각 항목에는 guid, name, isWikiEnabled가 담겨 있어요. GET /v1/external/workspaces/me는 계정 API Key의 기본 워크스페이스 또는 워크스페이스 API Key가 연결된 워크스페이스를 반환해요.
워크스페이스 단위 리소스는 workspaceGuid를 포함해요. 예를 들어 POST /v1/external/workspaces/{workspaceGuid}/folders는 해당 워크스페이스에 폴더를 만들어요. 계정 API Key 하나로 여러 워크스페이스를 연동할 때는 GET /v1/external/workspaces에서 현재 접근 가능한 workspaceGuid를 확인하세요.
Rate Limit
API Key 하나당 60초에 600개 요청을 보낼 수 있어요. 초과하면429 응답과 Retry-After·X-RateLimit-* 헤더를 받아요.
Rate Limit 초과
rate limit을 초과하면429 Too Many Requests 응답을 받아요.