레코드 목록 조회
GET
/crm-core/v1/records
레코드 목록을 조회합니다. 커서 기반 페이지네이션을 지원합니다.
참고
정렬 기준으로 사용할 수 있는 기본 필드: name, dateCreated, dateUpdated, recordId. 속성 ID를 직접 지정하여 속성 값 기준 정렬도 가능합니다.
Query Params
| 이름 | 타입 | 필수 여부 | 허용 연산자[?] | 설명 |
|---|---|---|---|---|
entityId | String | - | eq | 개체 ID로 필터링 |
keyword | String | - | eq | 레코드 이름으로 검색 |
filters | String | - | eq | 속성 필터 (JSON 문자열) 지원하는 연산자: `contains`, `eq`, `in`, `dateRange`, `numberRange`, `number` |
startKey | String | - | eq | 페이지네이션 시작 키 (이전 응답의 nextKey 값) |
limit | Number | - | eq | 조회 개수 제한 (1~500, 기본값: 20) |
sortField | String | - | eq | 정렬 기준 필드 (name, dateCreated, dateUpdated, recordId 또는 속성 ID) |
sortDirection | String | - | eq | 정렬 방향 (asc 또는 desc) |
Response
| 이름 | 타입 | 반드시 반환 | 설명 |
|---|---|---|---|
data | Array<object> | O | 레코드 목록 |
nextKey | String | - | 다음 페이지 조회를 위한 키 (마지막 페이지인 경우 미반환) |