GET/groups/{groupId}/note/posts/search

권한이 있는 조직/그룹 노트의 게시글을 검색한다.
검색어(query)는 필수이다.

  • 기본 검색 대상: 제목, 본문, 댓글, 첨부 파일명, 작성자명
  • 검색어는 대소문자를 구분하지 않으며, URL 인코딩을 적용해야 한다.
  • 검색 결과는 관련도(relevance) 내림차순으로 정렬된다.
  • 기간/작성자/첨부 필터는 지원하지 않으며 항상 전체 기간을 검색한다.
  • 응답은 노트 게시글 목록 조회와 동일한 모델을 사용하며, 검색 응답에서만 snippet이 추가로 제공된다.
  • readCount/likeCount는 검색 인덱스에 동기화되지 않아 항상 0이며, enableCollaboration은 항상 true이다.
  • 게시글 등록/수정 후 검색 인덱스 반영까지 수 초간 지연될 수 있다.
  • rate limit은 Open API 공통 rate limit 정책을 따른다.

Authorization

oauth2

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

Scope

group.note
group.note.read

HTTP Request

GEThttps://www.worksapis.com/v1.0/groups/{groupId}/note/posts/search

Path Parameters

ParameterTypeDescription
groupId string 

조직/그룹 ID


required
example : group127-8545-4463-603b-04d550d23bf 

Query Parameters

ParameterTypeDescription
query string 

검색어


required
minLength : 1
maxLength : 100
example : 회의록 
count integer 

목록 조회 개수


default : 20
minimum : 1
maximum : 40 
cursor string 

다음 목록 조회 시 사용하는 값


example : sfJogXpzDGY8OscZziqZpYqCAu3RbZbaFzBb1od6lWQtSdPUd2FIdCuaGgu8DA== 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Response

HTTP 200

OK

PropertyTypeDescription
posts array (posts) 

게시글 검색 결과 목록

 
responseMetaData object (responseMetaData) 

페이지 매김 처리를 위한 메타데이터

 

posts

PropertyTypeDescription
postId integer 

게시글 번호


format : int64 
title string 

제목


required
minLength : 1
maxLength : 200 
enableCollaboration boolean 

타인 편집 허용 여부

 
readCount integer 

읽은 횟수
게시글 검색 응답에서는 검색 인덱스에 동기화되지 않아 항상 0이다.


format : int64 
commentCount integer 

댓글 수


format : int64 
fileCount integer 

파일 수


format : int64 
likeCount integer 

좋아요 수
게시글 검색 응답에서는 검색 인덱스에 동기화되지 않아 항상 0이다.


format : int64 
createdTime string 

생성 시간


required
format : date-time
readOnly : true 
modifiedTime string 

수정 시간


format : date-time
readOnly : true 
userId string 

작성자 ID
탈퇴된 계정인 경우에는 빈값


readOnly : true
nullable : true 
userName string 

작성자 이름


required
readOnly : true 
isNotice boolean 

공지 사항 등록 여부

 
snippet string 

검색어와 일치한 부분의 발췌(최대 200자)
일치한 검색어는 <mark> 요소로 강조 표시되며, 그 외 HTML 태그는 포함되지 않는다.

 

responseMetaData

PropertyTypeDescription
nextCursor string 

다음 페이지 조회를 위한 커서

 

Response Example

example

1{2  "posts": [3    {4      "postId": 1,5      "title": "주간 회의록",6      "enableCollaboration": true,7      "readCount": 0,8      "commentCount": 2,9      "fileCount": 1,10      "likeCount": 0,11      "createdTime": "2026-04-20T10:30:00+09:00",12      "modifiedTime": "2026-04-21T14:15:00+09:00",13      "userId": "user7149-0ccd-433d-1eba-04f6901660dc",14      "userName": "Susan Nielsen",15      "isNotice": false,16      "snippet": "이번 주 <mark>회의록</mark>을 공유합니다."17    }18  ],19  "responseMetaData": {20    "nextCursor": "sfJogXpzDGY8OscZziqZpYqCAu3RbZbaFzBb1od6lWQtSdPUd2FIdCuaGgu8DA=="21  }22}