목적

이 API는 저장된 대화 이력(로그) 목록을 조회합니다. 검색어, 날짜 기간, 회원 ID 등을 기준으로 필터링할 수 있으며 페이징(Pagination)을 지원합니다.

URL

<aside> 💡

https://api.sidetalk.ai/v1/chat/logs

</aside>

HTTP 메서드

GET

헤더

헤더 값 설명
Content-Type application/json 요청 본문이 JSON 형식임을 나타냅니다.
Authorization Bearer <api_key> Sidetalk 대시보드에서 설치하기 메뉴에 제공된 API 키를 사용하세요.

파라미터 (Query String)

URL의 쿼리 스트링으로 전달되는 파라미터입니다.

파라미터 타입 필수 설명
keyword String 아니요 질문 또는 답변 내용에 포함된 검색어입니다.
startDate String 아니요 조회 시작 일시입니다. (형식: YYYYMMDDHHmmss, 예: 20240101000000)
endDate String 아니요 조회 종료 일시입니다. (형식: YYYYMMDDHHmmss, 예: 20240131235959)
memberId String 아니요 특정 회원의 대화만 조회할 경우 사용합니다.
page Number 아니요 조회할 페이지 번호입니다. 기본값은 1입니다.
limit Number 아니요 한 페이지당 조회할 항목의 개수입니다. 기본값은 20입니다.
sort String 아니요 정렬 순서입니다. desc(최신순) 또는 asc(과거순). 기본값은 desc입니다.

요청 예시


  curl -X GET "<https://api.sidetalk.ai/v1/chat/logs?page=1&limit=10&keyword=${keyword}\\>
  -H "Authorization: Bearer ${API_KEY}"