대화 목록 조회
검색 조건과 일치하는 AI 대화 목록을 조회합니다. 대화는 날짜별로 그룹화되어 반환됩니다.
HTTP 요청
GET /api/sonar/ai/conversations
cURL 예시
curl -H "Authorization: Bearer <API_KEY>" \
"https://HOSTNAME/api/sonar/ai/conversations?offset=0&limit=20"
요청 매개변수
| 키 | 필수 | 타입 | 설명 | 비고 |
|---|---|---|---|---|
| offset | O | 32비트 정수 | 건너뛸 갯수 | |
| limit | O | 32비트 정수 | 최대 갯수 | |
| keywords | X | 문자열 | 검색 키워드 | 대화 제목 대상 검색 |
정상 응답
{
"conversations": [
[
{
"guid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"title": "로그 분석 대화",
"created": "2024-01-15 10:30:00+0900",
"updated": "2024-01-15 11:00:00+0900"
}
]
]
}
- conversations (배열): 날짜별로 그룹화된 대화 목록의 배열
- 각 그룹 (배열): 같은 날짜에 생성된 대화 목록
- guid (문자열): 대화 고유 식별자
- title (문자열): 대화 제목
- created (문자열): 생성일시 (
yyyy-MM-dd HH:mm:ssZ형식) - updated (문자열): 수정일시 (
yyyy-MM-dd HH:mm:ssZ형식)
- 각 그룹 (배열): 같은 날짜에 생성된 대화 목록
오류 응답
offset, limit 값이 정수가 아닌 경우
HTTP 상태 코드 400 응답
{
"error_code": "invalid-argument",
"error_msg": "'offset' parameter should be int type"
}