API Bilgileri

KitapSosyal API, geliştiricilerin platformla entegre olmasını sağlar. Kitaplar, kullanıcılar, gönderiler ve daha fazlası hakkında bilgi alabilir, yeni içerikler oluşturabilirsiniz.

API Bilgileri

KitapSosyal API, geliştiricilerin KitapSosyal platformuna entegre olmasını sağlar. Bu API sayesinde kitaplar, kullanıcılar, gönderiler ve daha fazlası hakkında bilgi alabilir, yeni içerikler oluşturabilir ve platformla etkileşim kurabilirsiniz. API kullanımı için bir API anahtarına ihtiyacınız olacak.

Yetkilendirme

API kullanmak için yetkilendirme gereklidir. Tüm isteklerde geçerli bir API anahtarı sağlamanız gerekir.

API Anahtarı Alma

API anahtarı almak için hesabınıza giriş yapın, profil sayfanızdan "Geliştirici" bölümüne gidin ve "Yeni API Anahtarı Oluştur" butonuna tıklayın.

API Anahtarı Kullanımı

API anahtarınızı HTTP başlığında "Authorization: Bearer YOUR_API_KEY" şeklinde göndermelisiniz.

Hata Yanıtları

Geçersiz veya eksik API anahtarı durumunda 401 Unauthorized yanıtı alırsınız.

İstek ve Yanıt Formatları

Tüm API istekleri ve yanıtları JSON formatında kullanılır. İstekler için Content-Type başlığının "application/json" olarak ayarlanması gerekir.

HTTP Durum Kodları

API, standart HTTP durum kodlarını kullanır: 200 (Başarılı), 201 (Oluşturuldu), 400 (Hatalı İstek), 401 (Yetkisiz), 404 (Bulunamadı), 500 (Sunucu Hatası).

Sayfalama

Listeleme istekleri için sayfalama desteği vardır. "page" ve "limit" parametrelerini kullanarak sonuçları sayfalayabilirsiniz.

Hata Formatı

Hata durumlarında yanıt şu formatta olur: {"error": true, "message": "Hata mesajı", "code": 400}

API Endpointleri

Aşağıda KitapSosyal API'nin tüm endpointleri ve açıklamaları bulunmaktadır:
Metod URL Açıklama Parametreler Örnek
GET /api/books Tüm kitapları listeler page (sayfa), limit (sonuç sayısı), category (kategori ID), author (yazar ID) GET /api/books?page=1&limit=10&category=1
GET /api/books/{id} Belirli bir kitabın detaylarını getirir id (kitap ID) GET /api/books/123
POST /api/books Yeni kitap ekler title (başlık), author_id (yazar ID), publisher_id (yayınevi ID), category_id (kategori ID), description (açıklama), page_count (sayfa sayısı), publish_year (basım yılı) POST /api/books
GET /api/users Kullanıcıları listeler page (sayfa), limit (sonuç sayısı), search (arama terimi) GET /api/users?search=ahmet
GET /api/users/{id} Belirli bir kullanıcının profil bilgilerini getirir id (kullanıcı ID) GET /api/users/456
GET /api/posts Gönderileri listeler page (sayfa), limit (sonuç sayısı), user_id (kullanıcı ID), book_id (kitap ID), topic_id (konu ID) GET /api/posts?user_id=456&limit=5
POST /api/posts Yeni gönderi oluşturur user_id (kullanıcı ID), book_id (kitap ID), topic_id (konu ID), title (başlık), content (içerik) POST /api/posts
GET /api/comments Yorumları listeler page (sayfa), limit (sonuç sayısı), post_id (gönderi ID) GET /api/comments?post_id=789
POST /api/comments Yeni yorum ekler post_id (gönderi ID), user_id (kullanıcı ID), content (içerik) POST /api/comments
GET /api/clubs Kitap kulüplerini listeler page (sayfa), limit (sonuç sayısı) GET /api/clubs
GET /api/search Kitap, yazar ve kullanıcı araması yapar q (arama terimi), type (kitap/yazar/kullanıcı/hepsi) GET /api/search?q=dostoyevski&type=author

Kullanım Örnekleri

Aşağıda farklı programlama dillerinde API kullanım örnekleri bulunmaktadır:
cURL
JavaScript (Fetch)
Python (Requests)
PHP 
curl -X GET "https://api.kitapsosyal.com/api/books?page=1&limit=5" \\n     -H "Authorization: Bearer YOUR_API_KEY" \\n     -H "Content-Type: application/json"
fetch('https://api.kitapsosyal.com/api/books?page=1&limit=5', {\n  method: 'GET',\n  headers: {\n    'Authorization': 'Bearer YOUR_API_KEY',\n    'Content-Type': 'application/json'\n  }\n})\n.then(response => response.json())\n.then(data => console.log(data))\n.catch(error => console.error('Error:', error));
import requests\n\nurl = "https://api.kitapsosyal.com/api/books"\nheaders = {\n    "Authorization": "Bearer YOUR_API_KEY",\n    "Content-Type": "application/json"\n}\nparams = {"page": 1, "limit": 5}\n\nresponse = requests.get(url, headers=headers, params=params)\ndata = response.json()\nprint(data)
$ch = curl_init();\n\n$url = "https://api.kitapsosyal.com/api/books?page=1&limit=5";\n$headers = [\n    "Authorization: Bearer YOUR_API_KEY",\n    "Content-Type: application/json"\n];\n\ncurl_setopt($ch, CURLOPT_URL, $url);\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\n\n$response = curl_exec($ch);\n$data = json_decode($response, true);\n\ncurl_close($ch);\n\nprint_r($data);

Kullanım Sınırlamaları

API kullanımı aşağıdaki sınırlamalara tabidir:

İstek Limiti

Her API anahtarı için dakikada 100 istek limiti vardır. Bu limit aşıldığında 429 Too Many Requests yanıtı alırsınız.

Veri Limiti

Tek bir istekte en fazla 100 sonuç döndürülür. Daha fazla sonuç için sayfalama kullanmalısınız.

Boyut Limiti

POST isteklerinde gönderilen verinin boyutu 10MB'ı geçemez.

Sürüm ve Değişiklikler

API sürüm 1.0'dır. Gelecekte yeni sürümler yayınlanabilir. Önemli değişiklikler önceden duyurulacaktır.
v1.0
26 Eylül 2025
İlk API sürümü yayınlandı. Kitap, kullanıcı, gönderi, yorum ve arama endpointleri eklendi.

Geliştirici Desteği

API kullanımıyla ilgili sorularınız veya önerileriniz varsa, lütfen bizimle iletişime geçin:

İletişim Bilgileri

  • E-posta: [email protected]
  • Belgeler: https://docs.kitapsosyal.com/api
  • GitHub: https://github.com/kitapsosyal/api

Önemli Bilgi

API kullanımı için geçerli bir API anahtarına ihtiyacınız olacak. API anahtarınızı profil sayfanızdan oluşturabilirsiniz. API kullanımıyla ilgili sorularınız için geliştirici desteği ile iletişime geçebilirsiniz.

Son güncelleme: 26 Eylül 2025

API İle İlgili Sorularınız

API kullanımıyla ilgili sorularınız veya önerileriniz varsa, lütfen aşağıdaki formu kullanarak bizimle iletişime geçin.