대화 조회
지정한 AI 대화의 상세 정보를 채팅 내역과 함께 조회합니다.
HTTP 요청
GET /api/sonar/ai/conversations/:guid
cURL 예시
curl -H "Authorization: Bearer <API_KEY>" \
https://HOSTNAME/api/sonar/ai/conversations/a1b2c3d4-e5f6-7890-abcd-ef1234567890
요청 매개변수
경로 매개변수
| 키 | 타입 | 설명 | 비고 |
|---|---|---|---|
| guid | 문자열 | 대화 식별자 | 36자 GUID |
정상 응답
{
"conversation": {
"guid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"title": "로그 분석 대화",
"chats": [],
"created": "2024-01-15 10:30:00+0900",
"updated": "2024-01-15 11:00:00+0900"
}
}
- conversation (객체): 대화 정보
- guid (문자열): 대화 고유 식별자
- title (문자열): 대화 제목
- chats (배열): 채팅 메시지 목록
- created (문자열): 생성일시 (
yyyy-MM-dd HH:mm:ssZ형식) - updated (문자열): 수정일시 (
yyyy-MM-dd HH:mm:ssZ형식)
오류 응답
식별자가 GUID 형식이 아닌 경우
HTTP 상태 코드 400 응답
{
"error_code": "invalid-param-type",
"error_msg": "guid should be guid type."
}
대화가 존재하지 않는 경우
HTTP 상태 코드 500 응답
{
"error_code": "illegal-state",
"error_msg": "conversation not found"
}