starred/fonparam-backend
1
0
Fork 0
mirror of https://github.com/kemalersin/fonparam-backend.git synced 2026-04-26 17:55:54 +03:00
Code Issues Projects Packages Wiki Activity
No description
51 commits 1 branch 0 tags 263 KiB
Find a file
Exact
Kemal Ersin a98ed4008c Add historical data filter.
2025-07-18 13:58:26 +03:00
src Add historical data filter. 2025-07-18 13:58:26 +03:00
.env.example fix: API key loglama mantığı düzeltildi 2024-12-15 22:44:08 +03:00
.eslintrc İlk commit: Fonparam API altyapısı 2024-12-04 23:24:41 +03:00
.gitignore Whitelist kontrolüne IP aralıkları eklendi. 2024-12-18 11:44:55 +03:00
.nvmrc Whitelist kontrolüne IP aralıkları eklendi. 2024-12-18 11:44:55 +03:00
LICENSE Lisans eklendi 2024-12-10 15:40:40 +03:00
package-lock.json MCP eklendi. 2025-07-15 17:49:25 +03:00
package.json Add historical data filter. 2025-07-18 13:58:26 +03:00
README.md Lisans eklendi 2024-12-10 15:40:40 +03:00
tsconfig.json İlk commit: Fonparam API altyapısı 2024-12-04 23:24:41 +03:00

README.md

📊 FonParam API

FonParam, Türkiye'deki yatırım fonlarının verilerini sunan bir API servisidir.

✨ Özellikler

  • 📈 Yatırım fonlarının güncel ve geçmiş verilerini sorgulama
  • 🏢 Portföy yönetim şirketleri hakkında detaylı bilgiler
  • 🔄 Fonların karşılaştırmalı analizi
  • 📊 Performans istatistikleri ve getiri oranları

🚦 Rate Limiting

API'nin tüm endpointleri için rate limiting uygulanmaktadır:

  • ⏱️ Her endpoint için 15 dakikada maksimum 25 istek
  • 📅 Her endpoint için günlük maksimum 100 istek
  • ⚠️ Rate limit aşıldığında 429 (Too Many Requests) hatası döner
  • 🔒 Rate limit sayaçları IP bazlı tutulur

🚀 Kurulum

  1. Repoyu klonlayın:
git clone git@github.com:kemalersin/fonparam-backend.git
cd fonparam-backend
  1. Bağımlılıkları yükleyin:
npm install
  1. Örnek env dosyasını kopyalayıp düzenleyin:
cp .env.example .env
  1. Veritabanını oluşturun:
CREATE DATABASE fonparam CHARACTER SET utf8mb4 COLLATE utf8mb4_turkish_ci;
  1. Uygulamayı başlatın:
# 🔧 Geliştirme modu
npm run dev

# 🚀 Prodüksiyon modu
npm run build
npm start

📚 API Dokümantasyonu

API dokümantasyonuna http://localhost:3000/api-docs adresinden erişebilirsiniz.

🛠️ Teknolojiler

  • ⚡ Node.js & Express.js
  • 🎯 TypeScript
  • 🗄️ MySQL & Sequelize ORM
  • 📝 Swagger API Dokümantasyonu
  • 🔒 JWT Tabanlı Güvenlik
  • 🚦 Rate Limiting & Caching

🤝 Katkıda Bulunma

  1. Fork'layın
  2. Feature branch oluşturun (git checkout -b feature/amazing-feature)
  3. Değişikliklerinizi commit edin (git commit -m 'feat: amazing new feature')
  4. Branch'inizi push edin (git push origin feature/amazing-feature)
  5. Pull Request oluşturun

📜 Lisans

Bu proje MIT lisansı altında lisanslanmıştır. Detaylar için LICENSE dosyasına bakınız.