Get Chat History

Endpoint ini digunakan untuk membaca riwayat percakapan (history message) berdasarkan X-SESSION-ID.

Endpoint

GET

https://api.raga.ziwardingai.xyz/v1/api/open-api/workspaces/:workspace_id/history

Path Parameter

Parameter	Tipe	Keterangan
workspace_id	String	ID workspace Anda di sistem Raga. Wajib diisi di URL path.

Query Parameter

Parameter	Tipe	Keterangan
page	Integer	Opsional. Nomor halaman untuk paginasi. Default: 1
limit	Integer	Opsional. Jumlah data per halaman. Default: 300, Maksimal: 10.000

Headers

Header	Tipe	Keterangan
Authorization	String	Wajib. Berisi Bearer {app_key} untuk autentikasi.
X-SESSION-ID	String	Wajib. ID session chat untuk mengambil history percakapan.

Penjelasan

• Pastikan menggunakan X-SESSION-ID yang valid agar dapat mengambil data history percakapan.
• Pagination dapat diatur melalui parameter page dan limit.

Contoh Request (cURL)

curl --location 'https://api.raga.ziwardingai.xyz/v1/api/open-api/workspaces/123e4567-e89b-12d3-a456-426614174000/history?page=1&limit=10' \
--header 'X-SESSION-ID: f1e47f853c06ba8b25c86ff0cc28dab1' \
--header 'Authorization: Bearer YOUR_APP_KEY'

Contoh Response Sukses (HTTP 200)

{
  "code": 200,
  "data": {
    "results": [
      {
        "session_id": "9cdad43a61aba0bddd69ff283fc3301f",
        "workspace_id": "993e80fb-4a78-491b-9b5b-1cc8bb336afb",
        "chat": "halo",
        "like": false,
        "dislike": false,
        "id": "2f9ea87a-6408-4da4-9eed-139a2101b2ff",
        "llm": "local_v2",
        "response": "halo! bagaimana saya bisa membantu Anda hari ini?",
        "knowledge_source_detail": [
          {
            "type": "basic",
            "topic_id": [
              "1685d466-ddbd-4150-9750-2b1a56aa5bdd"
            ]
          }
        ],
        "created_at": "2025-06-18T05:38:19.742Z",
        "updated_at": "2025-06-18T05:38:19.742Z"
      }
    ],
    "total": 23,
    "page": 1,
    "limit": 300
  }
}

Keterangan Response

Field	Tipe	Keterangan
code	Integer	HTTP status code dari response (200 jika berhasil).
results	Array	Daftar objek chat history, index ke-0 adalah chat terbaru.
total	Integer	Total jumlah chat dalam session tersebut.
page	Integer	Halaman saat ini.
limit	Integer	Limit data per halaman.

Detail tiap item di results sama seperti response di endpoint kirim chat:

Field	Tipe	Keterangan
session_id	String	ID session chat.
workspace_id	String	ID workspace.
chat	String	Isi chat user.
like	Boolean	Status like dari user.
dislike	Boolean	Status dislike dari user.
id	String	ID unik dari chat.
llm	String	Model LLM yang digunakan.
response	String	Respon dari chatbot.
knowledge_source_detail	Array	Detail sumber pengetahuan yang digunakan.
created_at	String	Timestamp data dibuat.
updated_at	String	Timestamp data diperbarui.

Response API

Status Code	Keterangan	Pesan
200	OK (Success)	Request berhasil, data chat history dikembalikan.
403	Forbidden	Invalid app key or unauthorized access.