Base URL
모든 API 요청은 다음 주소로 보내세요.워크스페이스
모든 Tiro API 요청은 하나의 워크스페이스 안에서 동작해요. API 키는 발급한 워크스페이스의 노트, 전사, 요약, 폴더에만 접근해요.GET /v1/external/workspaces를 호출하면 계정이 접근할 수 있는 워크스페이스 목록을 받아요. 각 항목에는 guid, name, isWikiEnabled가 담겨 있어요. GET /v1/external/workspaces/me를 호출하면 현재 키가 매핑된 워크스페이스를 확인할 수 있어요.
워크스페이스 단위 리소스는 workspaceGuid를 포함해요. 예를 들어 POST /v1/external/workspaces/{workspaceGuid}/folders는 해당 워크스페이스에 폴더를 만들어요. 여러 워크스페이스를 연동하려면 워크스페이스마다 키를 발급하세요.
Rate Limit
API Key 하나당 60초에 600개 요청을 보낼 수 있어요. 초과하면429 응답과 Retry-After·X-RateLimit-* 헤더를 받아요.
Rate Limit 초과
rate limit을 초과하면429 Too Many Requests 응답을 받아요.