GET/users/{userId}/ainote/notes/{noteId}

내가 생성한 노트의 상세 정보를 조회한다.

Authorization

oauth2

OAuth 2.0 인증.
자세한 인증 방식은 인가·인증을 참고한다.

Scope

ainote
ainote.read

HTTP Request

GEThttps://www.worksapis.com/v1.0/users/{userId}/ainote/notes/{noteId}

Path Parameters

ParameterTypeDescription
userId string 

사용자 ID


required 
noteId string 

노트 ID


required
example : 0b7ab87a-134b-482a-83a2-6267131972ean 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Response

HTTP 200

OK

PropertyTypeDescription
noteId string 

노트 ID

 
workspaceId string 

워크스페이스 ID

 
userId string 

노트를 생성한 사용자 ID

 
title string 

노트 제목

 
createdTime string 

노트 생성 시각(YYYY-MM-DDThh:mm:ssTZD)

 
updatedTime string 

노트 업데이트 시각(YYYY-MM-DDThh:mm:ssTZD)

 
recognitionLanguage string 

인식 언어

  • ko: 한국어
  • en: 영어
  • ja: 일본어
  • zh-cn: 중국어(간체)
  • zh-tw: 중국어(번체)
  • enko: 한국어+영어
  • jako: 한국어+일본어

Allowed values : ko, en, ja, zh-cn, zh-tw, enko, jako 
audioDuration integer 

오디오 길이(단위: millisecond)

 
attendees array (Attendee) 

참석자 목록

 
scripts array (Script) 

변환된 스크립트

 
summary 

참고
이 필드는 deprecated되었으며 하위 호환을 위해 당분간 유지된다. 신규 연동에서는 summaries 필드 사용을 권장한다.


deprecated : true 
summaries array (SummaryItem) 

요약 목록

  • 요약이 없으면 빈 배열을 반환한다.

required 

Attendee

PropertyTypeDescription
attendeeId string 

참석자 ID

 
userId string 

사용자 ID


nullable : true 
attendeeName string 

참석자 이름

 

Script

PropertyTypeDescription
blockId string 

스크립트의 단위인 블록의 ID

 
text string 

변환된 텍스트 본문

 
attendeeId string 

발화자의 참석자 ID


nullable : true 
attendeeName string 

발화자 이름


nullable : true 
startOffset integer 

시작 시간(단위: millisecond)

 
endOffset integer 

종료 시간(단위: millisecond)

 

SummaryItem

PropertyTypeDescription
summaryId string 

요약 ID

 
summaryType string 

요약 종류

  • AI: AI 요약
  • TEMPLATE: 템플릿 요약
  • TIMELINE: 타임라인 요약

Allowed values : AI, TEMPLATE, TIMELINE 
summaryName string 

요약 이름

 
content string 

요약 내용(마크다운 형식)

 
createdTime string 

요약 생성 시각(YYYY-MM-DDThh:mm:ssTZD)

 
updatedTime string 

요약 업데이트 시각(YYYY-MM-DDThh:mm:ssTZD)

 

Response Example

Example

1{2  "noteId": "0b7ab87a-134b-482a-83a2-6267131972ean",3  "userId": "92d6973e-8960-482b-186d-03206fd78512",4  "workspaceId": "SA000000000d000000000",5  "createdTime": "2025-03-01T10:00:00+09:00",6  "updatedTime": "2025-03-01T10:00:00+09:00",7  "title": "새로운 노트",8  "recognitionLanguage": "ko",9  "audioDuration": 54120,10  "attendees": [11    {12      "attendeeId": "qZjXW25VL7jYVf922u4rDJa",13      "userId": "92d6973e-8960-482b-186d-03206fd78512",14      "attendeeName": "담당자"15    }16  ],17  "scripts": [18    {19      "blockId": "BiD4Y8xdpSLhhKPN6rFSjmb",20      "text": "반갑습니다. 저는 클로바노트 담당자입니다. 궁금한 내용이 있으면 편하게 물어봐 주세요.",21      "attendeeId": "qZjXW25VL7jYVf922u4rDJa",22      "attendeeName": "담당자",23      "startOffset": 0,24      "endOffset": 787025    }26  ],27  "summaries": [28    {29      "summaryId": "7kWc9RM2gRZSSN7rFqoX40u",30      "summaryType": "AI",31      "summaryName": "AI 요약",32      "content": "## 클로바노트 소개\n- 클로바노트는 대화를 기록하고 필요한 정보를 찾기 쉽게 도와주는 서비스이다.",33      "createdTime": "2025-03-01T10:00:00+09:00",34      "updatedTime": "2025-03-01T10:00:00+09:00"35    }36  ]37}