Skip to content

FAQ

Jump to bottom
muradinc edited this page Dec 22, 2025 · 2 revisions

Sık Sorulan Sorular (SSS)

EPINT kütüphanesi hakkında sık sorulan sorular ve cevapları.

Genel Sorular

EPINT nedir?

EPINT, EPİAŞ (Enerji Piyasaları İşletme A.Ş.) API'lerine erişim sağlayan bir Python kütüphanesidir.

Hangi Python versiyonları destekleniyor?

EPINT Python 3.11 ve üzeri versiyonları destekler.

Nasıl kurulur?

EPINT henüz PyPI'da yayınlanmadığı için GitHub'dan kurulum yapabilirsiniz:

pip install git+https://github.com/metehanboy/epint.git

veya geliştirme modunda:

pip install -e git+https://github.com/metehanboy/epint.git#egg=epint

Not: PyPI'da yayınlandığında pip install epint komutu ile kurulum yapabileceksiniz.

Kimlik bilgilerimi nasıl ayarlarım?

import epint as ep
ep.set_auth("kullanici_adi", "sifre")
ep.set_mode("prod")  # veya "test"

Kullanım Soruları

Tarih formatı nasıl olmalı?

Tarih parametreleri string veya datetime objesi olarak verilebilir:

# String format
ep.seffaflik_electricity.mcp_data(start='2025-12-10', end='2025-12-11')

# Datetime format
from datetime import datetime
ep.seffaflik_electricity.mcp_data(
    start=datetime(2025, 12, 10),
    end=datetime(2025, 12, 11)
)

Binary dosyaları (XLSX, PDF) nasıl kaydederim?

xlsx_data = ep.seffaflik_electricity.consumer_count_export(
    period='2025-10-01',
    export_type='XLSX'
)

with open('export.xlsx', 'wb') as f:
    f.write(xlsx_data.read())

Method isimlerini tam olarak bilmem gerekiyor mu?

Hayır, EPINT fuzzy matching kullanır. Küçük yazım hataları tolere edilir:

ep.seffaflik_electricity.mcp_data(...)
ep.seffaflik_electricity.mcpData(...)  # Aynı sonucu verir

Kategori alias'ları nelerdir?

Bazı kategoriler için kısa alias'lar mevcuttur:

  • transparency → seffaflik_electricity
  • naturalgas, cng, dogalgaz → seffaflik_natural_gas
  • invoice → reconciliation_invoice
  • bpm → reconciliation_bpm

Hata Sorunları

"Authentication required" hatası alıyorum

Kimlik bilgilerinizi doğru ayarladığınızdan emin olun:

ep.set_auth("kullanici_adi", "sifre")

"Date range too large" hatası alıyorum

EPINT otomatik olarak büyük tarih aralıklarını küçük parçalara böler. Eğer hala sorun yaşıyorsanız, tarih aralığınızı manuel olarak küçültün.

API rate limit hatası alıyorum

API rate limit'ine takıldıysanız, istekleriniz arasında bekleme süresi ekleyin:

import time

for date_range in date_ranges:
    result = ep.seffaflik_electricity.mcp_data(...)
    time.sleep(1)  # 1 saniye bekle

Geliştirme Soruları

Nasıl katkıda bulunabilirim?

CONTRIBUTING.md dosyasını inceleyin.

Test nasıl çalıştırılır?

pytest

Kod formatlaması nasıl yapılır?

black src/
isort src/

Diğer Sorular

Sorunuz burada yok mu?

Clone this wiki locally