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.
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:
GET /api/mythologicalFigures?lang=en
(Bu, İngilizce dilinde veri döndürür.)GET /api/mythologicalFigures?limit=3
(Bu, sadece 3 karakter döndürür.)Ö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" } ]
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:
GET /api/mythologicalFigures?limit=3
(Bu, sadece 3 karakter döndürür.)Ö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" } ]
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" }
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" }
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" }
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" } } }
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.