API Dokümantasyonu

AI Chatbot SaaS API endpoint'leri

API Kullanımı

API endpoint'lerini test etmek için Postman veya benzeri araçları kullanabilirsiniz.

📮 Postman'i İndirveya kendi HTTP client'inizi kullanın

🔐 Authentication

JWT Token

Type: Bearer Token

Dashboard API'leri için kullanılır. Login sonrası elde edilir.

Authorization: Bearer <token>

API Key

Type: Header

Widget entegrasyonu için kullanılır. Workspace ayarlarından alınır.

x-api-key: <api-key>

📋 API Endpoints

GET/api/auth/session

Mevcut oturum bilgilerini alır

Auth: JWT Token (opsiyonel)
GET/api/workspaces

Kullanıcının workspace'lerini listeler

Auth: JWT Token
POST/api/workspaces

Yeni workspace oluşturur

Auth: JWT Token
GET/api/workspaces/[id]/allowed-domains

Workspace'in izin verilen domain'lerini listeler

Auth: JWT Token
POST/api/workspaces/[id]/allowed-domains

Workspace'e yeni domain ekler

Auth: JWT Token
POST/api/chatbot

Chatbot ayarlarını günceller

Auth: JWT Token
POST/api/chat

AI chatbot ile mesajlaşma

Auth: API Key (x-api-key header)
POST/api/chat/cleanup

Eski conversation'ları temizler

Auth: JWT Token
POST/api/chat/end

Conversation'ı sonlandırır

Auth: API Key
POST/api/register

Yeni kullanıcı kaydı

Auth: Yok
GET/widget/[workspaceId]

Chatbot widget script'ini döndürür

Auth: Yok
GET/widget/script

Widget script URL'ini döndürür

Auth: Yok
GET/widget/script/[workspaceId]

Workspace'e özel widget script'i

Auth: Yok

💡 Kullanım Örnekleri

Chat API Kullanımı

curl -X POST http://localhost:3000/api/chat \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-workspace-api-key" \
  -d '{
    "message": "Merhaba",
    "conversationId": "conv_123"
  }'

Workspace API Kullanımı

curl -X GET http://localhost:3000/api/workspaces \
  -H "Authorization: Bearer your-jwt-token"
MERGEN