대화 조회

지정한 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"
}