Genel Bakış

Hoş geldiniz! Bu API, Türk mitolojisindeki karakterler hakkında bilgi edinmek isteyenler için kullanışlı bir kaynaktır. İster tüm figürleri listeleyin, ister belirli bir karakterin detaylarını öğrenin. Sadece admin kullanıcılar karakter ekleyip güncelleyebilir.

Temel Rotalar
1. Tüm Mitolojik Karakterleri Listele
GET /api/mythologicalFigures

Bu rotayı kullanarak veritabanındaki tüm mitolojik karakterlerin bilgilerine ulaşabilirsiniz. İsterseniz dil seçeneği ve limit ekleyerek sadece istediğiniz sayıda karakteri çekebilirsiniz.

Örnek İstek:

Örnek Yanıt:

[
    {
        "name": "Ülgen",
        "descriptions": {
            "short": "The sky god in Turkish mythology.",
            "long": "Ülgen is the sky god in Turkish mythology, symbolizing goodness and protective powers..."
        },
        "attributes": ["Creative power", "Protective", "Wise"],
        "symbols": "Sun",
        "associatedAnimals": ["Eagle"],
        "image": "https://example.com/images/ulgen.jpg"
    },
    {
        "name": "Erlik",
        "descriptions": {
            "short": "The god of the underworld in Turkish mythology.",
            "long": "Erlik is the god of the underworld in Turkish mythology, representing darkness and evil..."
        },
        "attributes": ["Dark power", "Underworld", "Strong"],
        "symbols": "Black horse",
        "associatedAnimals": ["Wolf"],
        "image": "https://example.com/images/erlik.jpg"
    }
]
            
2. Belirli Sayıda Mitolojik Karakter Listele
GET /api/mythologicalFigures?limit={number}

Bu rota, veritabanındaki belirli bir sayıda mitolojik karakterin bilgilerini döndürür. İstediğiniz karakter sayısını `limit` parametresi ile belirleyebilirsiniz. Eğer `limit` parametresi belirtilmezse, tüm karakterler döndürülür.

Örnek İstek:

Örnek Yanıt:

[
    {
        "name": "Ülgen",
        "descriptions": {
            "short": "The sky god in Turkish mythology.",
            "long": "Ülgen is the sky god in Turkish mythology, symbolizing goodness and protective powers..."
        },
        "attributes": ["Creative power", "Protective", "Wise"],
        "symbols": "Sun",
        "associatedAnimals": ["Eagle"],
        "image": "https://example.com/images/ulgen.jpg"
    },
    {
        "name": "Erlik",
        "descriptions": {
            "short": "The god of the underworld in Turkish mythology.",
            "long": "Erlik is the god of the underworld in Turkish mythology, representing darkness and evil..."
        },
        "attributes": ["Dark power", "Underworld", "Strong"],
        "symbols": "Black horse",
        "associatedAnimals": ["Wolf"],
        "image": "https://example.com/images/erlik.jpg"
    }
]
            
3. Belirli Bir Mitolojik Karakteri Getir
GET /api/mythologicalFigures/:id

Belirli bir karakterin detaylarını öğrenmek mi istiyorsunuz? Bu rota tam size göre!

Örnek İstek: GET /api/mythologicalFigures/1234567890abcdef?lang=en

Örnek Yanıt:

{
    "name": "Ülgen",
    "descriptions": {
        "short": "The sky god in Turkish mythology.",
        "long": "Ülgen is the sky god in Turkish mythology, symbolizing goodness and protective powers..."
    },
    "attributes": ["Creative power", "Protective", "Wise"],
    "symbols": "Sun",
    "associatedAnimals": ["Eagle"],
    "image": "https://example.com/images/ulgen.jpg"
}
            
4. Rastgele Bir Mitolojik Karakter Getir
GET /api/mythologicalFigures/random

Rastgele bir mitolojik karakterin detaylarını mı öğrenmek istiyorsunuz? Bu rota ile her seferinde farklı bir karakter alabilirsiniz!

Karakter detaylarını İngilizce almak için:

GET /api/mythologicalFigures/random?lang=en

Örnek İstek: GET /api/mythologicalFigures/random

Örnek Yanıt:

{
    "name": "Kayra Han",
    "descriptions": {
        "short": "Kayra Han, Altay Türklerine göre gökyüzündeki tanrıların en büyüğüdür. 17. katta oturur ve evrenin kaderini tayin eder.",
        "long": "Kayra Han, Altay Türklerine göre gökyüzündeki tanrıların en büyüğü olarak bilinir ve 17. katta oturur..."
    },
    "attributes": ["Yaratıcı", "Güçlü", "Evrenin düzeni"],
    "symbols": "Çam ağacı",
    "associatedAnimals": ["Kurt"],
    "image": "https://img-s2.onedio.com/id-553fad7eba1dc36d5679ae81/rev-0/w-635/listing/f-jpg-webp/s-401c305c6e8867974106ae1dc3dd959a160eb702.webp"
}
            
5. Yeni Mitolojik Karakter Ekle
POST /api/mythologicalFigures

Yeni bir karakter mi eklemek istiyorsunuz? Sadece admin kullanıcılar bu işlemi yapabilir. İşte nasıl yapacağınız:

Örnek İstek Gövdesi:

{
    "name": "Ülgen",
    "descriptions": {
        "short": {
            "tr": "Türk mitolojisinde gök tanrısıdır.",
            "en": "The sky god in Turkish mythology."
        },
        "long": {
            "tr": "Türk mitolojisinde gök tanrısıdır ve iyiliğin, koruyucu güçlerin simgesidir...",
            "en": "Ülgen is the sky god in Turkish mythology, symbolizing goodness and protective powers..."
        }
    },
    "attributes": {
        "tr": ["Yaratıcı güç", "Koruyucu", "Bilge"],
        "en": ["Creative power", "Protective", "Wise"]
    },
    "symbols": {
        "tr": "Güneş",
        "en": "Sun"
    },
    "associatedAnimals": {
        "tr": ["Kartal"],
        "en": ["Eagle"]
    },
    "image": "https://example.com/images/ulgen.jpg"
}
            
6. Mitolojik Karakter Güncelle
PATCH /api/mythologicalFigures/:id

Bu rota ile mevcut bir karakterin bilgilerini güncelleyebilirsiniz. Tabi ki bu da admin kullanıcılar için geçerli.

Örnek İstek Gövdesi:

{
    "name": "Ülgen",
    "descriptions": {
        "short": {
            "tr": "Güncellenmiş kısa açıklama",
            "en": "Updated short description"
        }
    }
}
            
7. Mitolojik Karakter Sil
DELETE /api/mythologicalFigures/:id

Bir karakteri silmek için bu rotayı kullanabilirsiniz. Unutmayın, bu işlem yalnızca admin kullanıcılar için geçerli.