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
저장
환경 변수로 저장하세요. 생성 대화 상자를 닫으면 다시 볼 수 없어요.
워크스페이스 찾기
노트는 워크스페이스 안에 있어요.GET /v1/external/workspaces로 접근 가능한 워크스페이스 목록을 받고, 응답의 workspaces 배열에서 원하는 항목의 guid 값을 골라두세요 — 아래에서 workspaceGuid로 씁니다.
워크스페이스 없이 호출하는
GET /v1/external/notes는 워크스페이스 개수와 무관하게 deprecated 엔드포인트입니다(하위 호환을 위해 계속 동작해요). 워크스페이스가 하나뿐이더라도 항상 GET /v1/external/workspaces/{workspaceGuid}/notes를 쓰세요.첫 요청 보내기
앞 단계에서 고른 워크스페이스guid로 노트 목록을 가져옵니다.
guid가 담겨 있어요.
이제 목록을 얻었으니 노트 데이터 모델을 읽고 각 guid로 무엇을 할 수 있는지 알아보세요 — 전사, 요약, 문서, 폴더까지요.