Folio API Documentation (v1)

Folio API, dijital ikizinizle (AI assistant) programatik olarak etkileşime geçmenizi sağlar. Bu dokümantasyon, API anahtarınızı nasıl alacağınızı, kimlik doğrulama sürecini ve mevcut uç noktaları (endpoints) kapsamaktadır.

---

🔐 Kimlik Doğrulama (Authentication)

Tüm API istekleri bir API anahtarı gerektirir. API anahtarınızı her isteğin başlığına (header) x-api-key olarak eklemelisiniz.

Örnek Header:

http
 
x-api-key: your_api_key_here

API Anahtarı Nasıl Alınır?

1. Folio Dashboard'una giriş yapın.
2. Sol menüden Settings > API Keys sekmesine gidin.
3. "Generate New Key" butonuna tıklayarak anahtarınızı oluşturun.
4. Anahtarınızı güvenli bir yerde saklayın (bir daha gösterilmeyebilir).

---

🚀 Temel Uç Noktalar (Endpoints)

1. AI Sorgu (Query)

Dijital ikizinize soru sormak ve yanıt almak için kullanılır.

• URL: /api/v1/query
• Metot: POST
• İzinler: Premium Abonelik Gereklidir.

Request Body (JSON)

Örnek İstek (curl):

bash
 
curl -X POST https://twinly.me/api/v1/query \
  -H "x-api-key: FL_123456789" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "Uzmanlık alanların nelerdir?",
    "history": [
      {"role": "user", "parts": "Merhaba!"},
      {"role": "model", "parts": "Selam, size nasıl yardımcı olabilirim?"}
    ]
  }'

Response Body (JSON)

json
 
{
  "response": "Benim uzmanlık alanlarım modern web teknolojileri, yapay zeka entegrasyonu ve...",
  "usage": {
    "remaining": 95,
    "limit": 100
  }
}

---

🚦 Limitler ve Kota (Rate Limiting)

Folio API, kötüye kullanımı önlemek ve adil kullanımı sağlamak için kotalar uygular:

• Günlük Limit: Abonelik planınıza göre değişir (Standart Premium için günlük 100 istek).
• Hata Mesajı: Kota dolduğunda API 429 Too Many Requests yanıtı döner.
• Kota Sıfırlanma: Her gün gece yarısı (00:00) kullanıcı bazlı sıfırlanır.

---

❌ Hata Kodları

---

🛠️ SDK / Örnek Kullanım (JavaScript)

javascript
 
async function askAI(question) {
  const response = await fetch('https://twinly.me/api/v1/query', {
    method: 'POST',
    headers: {
      'x-api-key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ question })
  });

  const data = await response.json();
  if (response.ok) {
    console.log("AI Yanıtı:", data.response);
  } else {
    console.error("Hata:", data.error);
  }
}