Skip to main content
백엔드에서는 REST API를, Claude나 ChatGPT 같은 AI 클라이언트에서는 MCP Server를 사용하세요.

API Key 발급

Tiro Platform API Keys 페이지로 이동해 계정 API Key를 생성하세요. 계정 API Key는 현재 접근할 수 있는 모든 워크스페이스에서 사용자와 같은 권한으로 동작해요.
1

로그인

platform.tiro.ooo/me/api-keys로 이동하세요.
2

계정 API Key 생성

Create New API Key를 클릭하세요. 점(.)을 포함한 전체 키를 복사하세요 — abc123.xR7mK9pL2qW4....
3

저장

환경 변수로 저장하세요. 생성 대화 상자를 닫으면 다시 볼 수 없어요.
API Key는 환경 변수에 저장하세요. 절대 하드코딩하거나 커밋하지 마세요.

워크스페이스 찾기

노트는 워크스페이스 안에 있어요. GET /v1/external/workspaces로 접근 가능한 워크스페이스 목록을 받고, 응답의 workspaces 배열에서 원하는 항목의 guid 값을 골라두세요 — 아래에서 workspaceGuid로 씁니다.
워크스페이스 없이 호출하는 GET /v1/external/notes는 워크스페이스 개수와 무관하게 deprecated 엔드포인트입니다(하위 호환을 위해 계속 동작해요). 워크스페이스가 하나뿐이더라도 항상 GET /v1/external/workspaces/{workspaceGuid}/notes를 쓰세요.

첫 요청 보내기

앞 단계에서 고른 워크스페이스 guid로 노트 목록을 가져옵니다.
Tiro는 노트 목록을 페이지네이션된 형태로 반환해요. 각 객체에는 제목, 생성 날짜, 처리 상태, 그리고 전사·요약·문서를 가져올 때 사용하는 guid가 담겨 있어요. 이제 목록을 얻었으니 노트 데이터 모델을 읽고 각 guid로 무엇을 할 수 있는지 알아보세요 — 전사, 요약, 문서, 폴더까지요.