채팅 추가
지정한 AI 대화에서 AI에 질문을 전송합니다.
HTTP 요청
POST /api/sonar/ai/conversations/:guid/chats
cURL 예시
curl -H "Authorization: Bearer <API_KEY>" \
-d question="최근 로그인 실패 내역을 조회해 주세요." \
-X POST \
https://HOSTNAME/api/sonar/ai/conversations/a1b2c3d4-e5f6-7890-abcd-ef1234567890/chats
요청 매개변수
경로 매개변수
| 키 | 타입 | 설명 | 비고 |
|---|---|---|---|
| guid | 문자열 | 대화 식별자 | 36자 GUID |
요청 본문 매개변수
| 키 | 필수 | 타입 | 설명 | 비고 |
|---|---|---|---|---|
| question | O | 문자열 | 질문 내용 | |
| mode | X | 문자열 | 대화 모드 |
정상 응답
{
"guid": "b2c3d4e5-f6a7-8901-bcde-f12345678901"
}
- guid (문자열): 생성된 채팅 메시지의 고유 식별자
오류 응답
식별자가 GUID 형식이 아닌 경우
HTTP 상태 코드 400 응답
{
"error_code": "invalid-param-type",
"error_msg": "guid should be guid type."
}
필수 매개변수가 누락된 경우
HTTP 상태 코드 400 응답
{
"error_code": "null-argument",
"error_msg": "question should be not null"
}