Kontör Durumu

# Kontör Durumu

Firmanın bağlı olduğu müşteri hesabının güncel kontör durumunu döndürür (eski sistemdeki Finans → Kontör ekranının karşılığı). Kalan kontör OINT_ACCTOTAL toplamlarından (yüklenen - harcanan), kullanım kırılımı OINT_ACCMONTHLYUSAGE tablosundan hesaplanır; aylık kullanım ve kontörün tahmini kaç gün yeteceği de yanıttadır (son 12 ayın kırılımı yalnızca son_12_ay_goster=true verilirse döner). Sonuç müşteri bazında cache'te tutulur; cache_ttl parametresi (sn, varsayılan 300, en az 30, en fazla 86400) verinin kabul edilen en fazla yaşını belirler; veri bundan eskiyse yeniden hesaplanır (hesaplama zamanı yanıttaki hesaplama_zamani alanındadır). Okuma kontör sunucusundan yapılır (kontör tabloları canlı ana veritabanında tutulmaz). Giriş gerektirir (bearer ya da basic auth).

## Parametreler

- **firma_reference** (integer, isteğe bağlı): Kontör durumu okunacak firmanın (mükellefin) referansı. Verilmezse oturumun seçili firması kullanılır. Kontör, firmanın bağlı olduğu müşteri hesabına aittir. Örnek: `42`
- **son_12_ay_goster** (boolean, isteğe bağlı): true verilirse yanıta son 12 ayın kullanım kırılımı (son_12_ay listesi) eklenir. Varsayılan false. Örnek: `false`
- **cache_ttl** (integer, isteğe bağlı): Cache'teki verinin kabul edilen en fazla yaşı (saniye). Varsayılan 300; 30 ile 86400 arasına sıkıştırılır. Veri bundan eskiyse yeniden hesaplanır — küçük bir değer güncel veriyi zorlar. Örnek: `300`
- **bearer** (string, isteğe bağlı): Bearer GUID (Authorization: Bearer başlığı yerine payload ile de gönderilebilir). Örnek: `"9b2f6c1e-0d4a-4a7e-9c3b-1f2e3d4c5b6a"`
- **musteri** (string, isteğe bağlı): Basic auth için müşteri (firma) kodu. Örnek: `"demo"`
- **kullanici** (string, isteğe bağlı): Basic auth için kullanıcı adı. Örnek: `"ali"`
- **sifre** (string, isteğe bağlı): Basic auth için şifre. Loglara asla yazılmaz. Örnek: `"gizli123"`

## Örnek İstek

```json
{
    "bearer": "9b2f6c1e-0d4a-4a7e-9c3b-1f2e3d4c5b6a",
    "firma_reference": 42,
    "son_12_ay_goster": true
}
```

## Örnek Yanıt (olumlu)

```json
{
    "basarili": true,
    "mesaj": "Kontör durumu",
    "veri": {
        "firma": {
            "reference": 42,
            "kod": "ORNEK",
            "vkn": "1234567890",
            "unvan": "Örnek Firma A.Ş."
        },
        "musteri": {
            "reference": 7,
            "kod": "demo",
            "unvan": "Demo Bilişim A.Ş."
        },
        "kontor": {
            "kalan": 12345,
            "yuklenen": 50000,
            "harcanan": 37655,
            "aylik_kullanim": 1200,
            "yillik_kullanim": 14400,
            "tahmini_gun": 309
        },
        "kullanim_toplamlari": {
            "harcanan_kontor": 37655,
            "efatura": 21000,
            "earsiv": 14000,
            "eposta": 9000,
            "sms": 120,
            "imzali_pdf": 800,
            "arsiv_dosyasi": 45,
            "arsiv_boyutu_mb": 512,
            "firma_sayisi": 3
        },
        "son_12_ay": [
            {
                "ay": "2026-06",
                "harcanan_kontor": 1200,
                "efatura": 700,
                "earsiv": 420,
                "eposta": 300,
                "sms": 4,
                "imzali_pdf": 25,
                "arsiv_dosyasi": 2,
                "arsiv_boyutu_mb": 16
            }
        ],
        "hesaplama_zamani": "2026-07-21 13:05:00",
        "cache_ttl": 300
    }
}
```

## Örnek Yanıt (olumsuz)

```json
{
    "basarili": false,
    "mesaj": "Bu firma için yetkiniz yok ya da firma bulunamadı.",
    "veri": null
}
```