채팅 목록 조회

지정한 AI 대화의 채팅 메시지 목록을 조회합니다.

HTTP 요청

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     "https://HOSTNAME/api/sonar/ai/conversations/a1b2c3d4-e5f6-7890-abcd-ef1234567890/chats?limit=20"

요청 매개변수

경로 매개변수

요청 본문 매개변수

정상 응답

{
  "chats": [
    {
      "guid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "question": "최근 로그인 실패 내역을 조회해 주세요.",
      "answer": "최근 로그인 실패 내역을 조회하겠습니다.",
      "mode": "qna",
      "created": "2024-01-15 10:31:00+0900"
    }
  ]
}

• chats (배열): 채팅 메시지 목록
  • guid (문자열): 채팅 메시지 고유 식별자
  • question (문자열): 사용자 질문
  • answer (문자열): AI 응답
  • mode (문자열): 대화 모드
  • created (문자열): 생성일시 (yyyy-MM-dd HH:mm:ssZ 형식)

오류 응답

식별자가 GUID 형식이 아닌 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-param-type",
  "error_msg": "guid should be guid type."
}

limit 값이 정수가 아닌 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "'limit' parameter should be int type"
}