Arşivlenen Dosyalar

# Arşivlenen Dosyalar

Kullanıcının yetkili olduğu firmalara ait arşivlenmiş dosya kayıtlarını sayfalı listeler. Giriş gerektirir (bearer ya da basic auth). Her kaydın altındaki dosyaların adı, boyutu ve özeti de döner; dosya içeriği için arsivlenen_dosya_indir servisi kullanılır.

## Parametreler

- **kategori** (string, isteğe bağlı): Arşiv kategorisi (docCat) tam eşleşmesi: muhasebe, edefter, efatura, genel, sql, evrak. Örnek: `"edefter"`
- **belge_adi** (string, isteğe bağlı): Dosya adı içinde geçen arama (docName). Örnek: `"berat"`
- **aciklama** (string, isteğe bağlı): Açıklama içinde geçen arama. Örnek: `"2026\/01 dönemi"`
- **yukleme_tarihi_baslangic** (string, isteğe bağlı): Yükleme tarihi aralığının başlangıcı (YYYY-AA-GG ya da YYYY-AA-GG SS:DD:SS). Örnek: `"2026-01-01"`
- **yukleme_tarihi_bitis** (string, isteğe bağlı): Yükleme tarihi aralığının bitişi. Saat verilmezse gün sonu (23:59:59) kabul edilir. Örnek: `"2026-01-31"`
- **firma_reference** (integer, isteğe bağlı): Yalnızca bu firmanın (mükellefin) arşivinde ara. Verilmezse yetkili olunan tüm firmalar taranır. Örnek: `42`
- **dosyalari_getir** (boolean, isteğe bağlı): Her kaydın altındaki dosyaların dökümü de dönsün mü (varsayılan true). false verilirse yalnızca başlık bilgileri döner. Örnek: `true`
- **page** (integer, isteğe bağlı): Sayfa numarası (1 tabanlı, varsayılan 1). Örnek: `1`
- **pageSize** (integer, isteğe bağlı): Sayfa başına kayıt sayısı (varsayılan 50, en fazla 200). Örnek: `50`
- **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",
    "kategori": "edefter",
    "yukleme_tarihi_baslangic": "2026-01-01",
    "yukleme_tarihi_bitis": "2026-01-31",
    "page": 1,
    "pageSize": 50
}
```

## Örnek Yanıt (olumlu)

```json
{
    "basarili": true,
    "mesaj": "Arşivlenen dosyalar",
    "veri": {
        "sayfa": 1,
        "sayfa_boyutu": 50,
        "devamVar": false,
        "kayitlar": [
            {
                "reference": 58120,
                "firma_reference": 42,
                "musteri_reference": 7,
                "kategori": "edefter",
                "kategori_adi": "E-Defter",
                "aciklama": "2026/01 dönemi beratları",
                "belge_adi": "1234567890-202601-Y-0000.zip ; 1234567890-202601-K-0000.zip",
                "dosya_adedi": 2,
                "boyut": 5242880,
                "boyut_okunabilir": "5,00 MB",
                "kontor": 5,
                "yukleme_tarihi": "2026-02-10 14:22:31",
                "belge_tarihi": "2026-02-10 14:22:31",
                "dosyalar": [
                    {
                        "id": 91234,
                        "ad": "1234567890-202601-Y-0000.zip",
                        "boyut": 3145728,
                        "boyut_okunabilir": "3,00 MB",
                        "ozet": "a3f1c9e2b5d47a8c0e6f1b2d3c4a5e6f",
                        "tarih": "2026-02-10 14:22:31"
                    }
                ]
            }
        ]
    }
}
```

## Örnek Yanıt (olumsuz)

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