Aigency API'ye Hoş Geldiniz

Güçlü AI asistanlarını uygulamalarınıza entegre edin

✨ Neler Yapabilirsiniz?

Çoklu AI Modelleri

GPT-4, Claude, Gemini ve daha fazlası

Gerçek Zamanlı Sohbet

Anlık mesajlaşma ve yanıtlar

Sohbet Geçmişi

Konuşmaları kaydedin ve devam ettirin

Güvenli Entegrasyon

API key ile korumalı erişim

Aigency API'si, kendi uygulamalarınıza güçlü yapay zeka asistanları entegre etmeniz için tasarlanmış modern bir RESTful API'dir. Basit HTTP istekleri ile sohbet oturumları oluşturabilir, yönetebilir ve AI asistanları ile etkileşimde bulunabilirsiniz.

Kimlik Doğrulama

API'yi kullanmak için öncelikle bir API anahtarı edinmeniz gerekir. Bu anahtar, tüm API isteklerinizde kullanılacaktır.

Güvenlik Notu

API anahtarınızı güvenli bir yerde saklayın ve asla istemci tarafı kodunda kullanmayın. Sadece sunucu tarafında kullanın.

Authorization Header

curl -X POST https://aigency.dev/api/v2/chat/create \
  -H "Authorization: Bearer sizin_api_anahtarınız" \
  -H "Content-Type: application/json"

Hızlı Başlangıç

3 basit adımda AI asistanınızla sohbet etmeye başlayın:

Yeni Sohbet Oluştur

POST /chat/create

const response = await fetch('https://aigency.dev/api/v2/chat/create', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sizin_api_anahtarınız',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'gpt-4',
    temperature: 0.7
  })
});

const data = await response.json();
console.log(data.sessionId);

Mesaj Gönder

POST /chat/message

const messageResponse = await fetch('https://aigency.dev/api/v2/chat/message', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sizin_api_anahtarınız',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    sessionId: data.sessionId,
    message: 'Merhaba! Bugün nasılsın?'
  })
});

const reply = await messageResponse.json();
console.log(reply.response);

API Endpoints

POST/chat/create

Yeni bir sohbet oturumu başlatır ve benzersiz bir oturum ID'si döndürür.

Örnek İstek

curl -X POST https://aigency.dev/api/v2/chat/create \
  -H "Authorization: Bearer sizin_api_anahtarınız" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4",
    "temperature": 0.8
  }'

Başarılı Yanıt

{
  "success": true,
  "sessionId": "550e8400-e29b-41d4-a716-446655440000",
  "model": "gpt-4",
  "createdAt": "2024-01-15T10:30:00Z"
}

POST/chat/message

Mevcut bir sohbet oturumuna mesaj gönderir ve AI'nin yanıtını alır.

Python Örneği

import requests

url = "https://aigency.dev/api/v2/chat/message"
headers = {
    "Authorization": f"Bearer sizin_api_anahtarınız",
    "Content-Type": "application/json"
}

data = {
    "sessionId": "550e8400-e29b-41d4-a716-446655440000",
    "message": "Python'da fibonacci dizisi nasıl yazılır?"
}

response = requests.post(url, json=data, headers=headers)
print(response.json()["response"])

GET/chat/history/:sessionId

Belirtilen oturumun tüm mesaj geçmişini getirir.

Örnek İstek

curl -X GET https://aigency.dev/api/v2/chat/history/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer sizin_api_anahtarınız"

Hata Yönetimi

API, standart HTTP durum kodları ve açıklayıcı hata mesajları döndürür.

200OK

İstek başarılı

400Bad Request

Geçersiz istek parametreleri

401Unauthorized

Geçersiz veya eksik API anahtarı

404Not Found

Kaynak bulunamadı

429Too Many Requests

Rate limit aşıldı

500Internal Server Error

Sunucu hatası

Hata Yanıt Formatı

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Geçersiz API anahtarı",
    "details": "Lütfen geçerli bir API anahtarı kullanın"
  }
}

🔧 SDK & Kod Örnekleri

Farklı programlama dilleri için hazır SDK'larımızı kullanabilirsiniz.

JavaScript/TypeScript

BASH

npm install @aigency/sdk

JAVASCRIPT

import { AIGency } from '@aigency/sdk';

const client = new AIGency({
  apiKey: 'sizin_api_anahtarınız'
});

const session = await client.chat.create({
  model: 'gpt-4'
});

const response = await client.chat.sendMessage({
  sessionId: session.id,
  message: 'Merhaba!'
});

Python