Liya AILiya AI
Giriş Yap

Liya AI API'ye Hoş Geldiniz

Liya AI API, AI asistanlarınızı projelerinize entegre etmenizi sağlayan güçlü bir RESTful API'dir. Bu dokümantasyon, API'yi kullanmaya başlamanız için gereken tüm bilgileri içerir.

Güvenli

API anahtarları ile güvenli erişim

Hızlı

Düşük gecikme süreli yanıtlar

Ölçeklenebilir

Yüksek trafik için optimize edilmiş

Kimlik Doğrulama

Tüm API isteklerinde X-API-Key header'ı ile API anahtarınızı göndermeniz gerekmektedir.

GET /api/v1/external/assistants/
X-API-Key: your_api_key_here

API Endpoint'leri

GET/api/v1/external/assistants/

Projenize ait tüm asistanları listeler

POST/api/v1/external/chat/

Belirtilen asistana mesaj gönderir ve yanıt alır

Body: assistant_id, message, external_id

Oturumlar

Kullanıcı oturumlarını yönetin ve mesaj geçmişine erişin

GET/api/v1/external/sessions/

Belirtilen asistana ait tüm oturumları listeler

Query: assistant_id (required), limit, offset
POST/api/v1/external/sessions/

Yeni bir sohbet oturumu oluşturur

Body: assistant_id, session_name (optional), external_session_id (optional)
GET/api/v1/external/sessions/{'{session_id}'}/

Belirtilen oturumun detaylarını getirir

DELETE/api/v1/external/sessions/{'{session_id}'}/

Belirtilen oturumu kapatır

GET/api/v1/external/sessions/{'{session_id}'}/history/

Belirtilen oturumun mesaj geçmişini getirir

Query: limit (default: 50, max: 100), offset

Oturum Yönetimi Örneği

// 1. Create a new session
const createSession = await fetch('/api/v1/external/sessions/', {
  method: 'POST',
  headers: {
    'X-API-Key': 'your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    assistant_id: 'asst_xxx',
    session_name: 'Customer Support Chat',
    external_session_id: 'user_123'
  })
});
const session = await createSession.json();
// session.data.id = "session_uuid"

// 2. Send messages using session_id
const chat = await fetch('/api/v1/external/chat/', {
  method: 'POST',
  headers: {
    'X-API-Key': 'your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    assistant_id: 'asst_xxx',
    session_id: session.data.id,
    message: 'Hello!'
  })
});

// 3. Get message history
const history = await fetch(
  `/api/v1/external/sessions/${session.data.id}/history/`,
  { headers: { 'X-API-Key': 'your_api_key' } }
);
const messages = await history.json();
// messages.data.messages = [{ role: 'user', content: '...' }, ...]

// 4. List all sessions for an assistant
const sessions = await fetch(
  '/api/v1/external/sessions/?assistant_id=asst_xxx',
  { headers: { 'X-API-Key': 'your_api_key' } }
);
const sessionList = await sessions.json();
// sessionList.data.sessions = [{ id, session_name, message_count, ... }]

npm Paketleri

Projelerinize hızlı entegrasyon için hazır npm paketlerimizi kullanın

Vanilla JavaScript

liya-ai-chat-js

Tüm web projeleri için uygun, framework bağımsız chat widget

npm install liya-ai-chat-js
npm'de görüntüle

React

liya-ai-chat-react

React uygulamaları için TypeScript destekli bileşenler

npm install liya-ai-chat-react
npm'de görüntüle

Vue 3

liya-ai-chat

Vue 3 ve Nuxt için composable tabanlı entegrasyon

npm install liya-ai-chat
npm'de görüntüle

Hızlı Başlangıç - Vanilla JS

<!-- 1. Paketi yükleyin -->
npm install liya-ai-chat-js

<!-- 2. Projenize ekleyin -->
import { LiyaChat } from 'liya-ai-chat-js';

<!-- 3. Kullanmaya başlayın -->
LiyaChat.init({
  apiKey: 'your_api_key',
  assistantId: 'your_assistant_id',
  position: 'bottom-right'
});

Kod Örnekleri

import axios from 'axios';

const api = axios.create({
  baseURL: 'https://app-1-ai.liyalabs.com',
  headers: {
    'X-API-Key': 'your_api_key_here'
  }
});

// List assistants
async function getAssistants() {
  const response = await api.get('/api/v1/external/assistants/');
  return response.data;
}

// Send message
async function sendMessage(assistantId, message, customerId) {
  const response = await api.post('/api/v1/external/chat/', {
    assistant_id: assistantId,
    message: message,
    external_id: customerId
  });
  return response.data;
}
Başlayın

API Anahtarınızı Alın

Hesap oluşturun, proje ekleyin ve API anahtarınızı alarak entegrasyona başlayın.

Hesap Oluştur