API Dokümantasyonu

İlk Fikir'in genel okuma API'si herkese açıktır. Kimlik doğrulama gerekmez. Tüm endpoint'ler JSON döndürür.

Hız Sınırı

Anonim (IP bazlı)60 istek / dakika
Oturum açık kullanıcı120 istek / dakika

Limit aşıldığında 429 Too Many Requests döner.

Endpoint'ler

GET /api/v1/stories

Gönderi listesini döndürür.

ParametreDeğerlerVarsayılan
sortpuan | yeni | tartismapuan
pagesayı1
{
  "page": 1,
  "totalPages": 3,
  "totalItems": 87,
  "stories": [
    {
      "id": "abc123",
      "title": "Örnek başlık",
      "url": "https://ornek.com",
      "domain": "ornek.com",
      "text": null,
      "type": "normal",
      "points": 42,
      "comment_count": 7,
      "created": "2025-06-01 10:00:00.000Z",
      "author": "kullanici"
    }
  ]
}
GET /api/v1/stories/:id

Tek bir gönderiyi döndürür.

GET /api/v1/stories/:id/comments

Gönderiye ait yorumları iç içe ağaç yapısında döndürür. Silinmiş yorumlar body: null olarak işaretlenir.

{
  "story_id": "abc123",
  "comments": [
    {
      "id": "cmt1",
      "body": "Yorum metni",
      "is_deleted": false,
      "author": "kullanici",
      "points": 3,
      "depth": 0,
      "created": "2025-06-01 11:00:00.000Z",
      "updated": "2025-06-01 11:00:00.000Z",
      "children": []
    }
  ]
}
GET /api/v1/stories/:id/votes

Gönderinin oy sayısını döndürür.

{
  "story_id": "abc123",
  "points": 42,
  "vote_count": 42
}