Skip to main content
Tiro API에서 노트, 전사, 요약, 폴더를 조회하고 관리해요.

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 응답을 받아요.

응답 형식

모든 API 응답은 일관된 JSON 형식을 따라요.

성공 응답 (목록)

성공 응답 (단일 리소스)

에러 응답

에러에는 디버깅에 도움이 되는 상세 정보가 포함돼요.