# Gazete arşivi

`GET https://ulawk.com/api/v1/gazeteler/`

Tüm ilanlarınızın arşivdeki gazeteleri: ilan, şirket, gazete kimliği, sayfa sayısı, boyut ve PDF bağlantısı. Sayfalı.

## Kimlik doğrulama

Her istekte iki başlık: `X-API-Key` ve `X-API-Secret`.

## Sorgu parametreleri

- `sayfa` (integer) — Sayfa numarası (1'den).
- `adet` (integer) — Sayfa başına kayıt (varsayılan 100, en çok 500).

## Yanıt

### 200 — Gazeteler.

- `toplam` (integer, zorunlu)
- `sayfa` (integer, zorunlu)
- `adet` (integer, zorunlu) — Sayfa başına kayıt.
- `gazeteler[]` (GazeteKaydi[], zorunlu)
- `gazeteler[].ilan_id` (integer, zorunlu)
- `gazeteler[].tarih` (string (date), zorunlu)
- `gazeteler[].tur` (string, zorunlu)
- `gazeteler[].sirket` (object, zorunlu)
- `gazeteler[].sirket.id` (integer | string, zorunlu) — Şirket kimliği: gerçek anahtarda sayısal (ör. 1234); deneme anahtarında DENEME-… metni.
- `gazeteler[].sirket.unvan` (string, null, zorunlu)
- `gazeteler[].sirket.sicil_no` (string, null, zorunlu)
- `gazeteler[].gazete` (object, zorunlu)
- `gazeteler[].gazete.guid` (string, zorunlu)
- `gazeteler[].gazete.boyut_bayt` (integer, null, zorunlu)
- `gazeteler[].gazete.sayfa_sayisi` (integer, null, zorunlu)
- `gazeteler[].gazete.ocr_var` (boolean, zorunlu)
- `gazeteler[].gazete.indirme` (string (date-time), null, zorunlu)
- `gazeteler[].pdf` (string (uri), zorunlu)

```json
{
  "toplam": 270,
  "sayfa": 1,
  "adet": 2,
  "gazeteler": [
    {
      "ilan_id": 9000005,
      "tarih": "2026-10-16",
      "tur": "TEMSİL VE İLZAM / YETKİLİ ATAMA",
      "sirket": {
        "id": "DENEME-100001",
        "unvan": "ÖRNEK DENEME SANAYİ VE TİCARET ANONİM ŞİRKETİ",
        "sicil_no": "DENEME-100001"
      },
      "gazete": {
        "guid": "deneme-9000005",
        "boyut_bayt": 636,
        "sayfa_sayisi": 1,
        "ocr_var": false,
        "indirme": "2026-10-01T00:00:00+03:00"
      },
      "pdf": "https://ulawk.com/api/v1/ilanlar/9000005/pdf/"
    },
    {
      "ilan_id": 9060002,
      "tarih": "2026-10-15",
      "tur": "TASFİYENİN SONA ERMESİ VE TERKİN",
      "sirket": {
        "id": "DENEME-TERKIN",
        "unvan": "ÖRNEK DENEME TEKSTİL LİMİTED ŞİRKETİ",
        "sicil_no": "DENEME-TERKIN"
      },
      "gazete": {
        "guid": "deneme-9060002",
        "boyut_bayt": 636,
        "sayfa_sayisi": 1,
        "ocr_var": false,
        "indirme": "2026-10-01T00:00:00+03:00"
      },
      "pdf": "https://ulawk.com/api/v1/ilanlar/9060002/pdf/"
    }
  ]
}
```

### 400 — Geçersiz parametre (`gecersiz_parametre`, `gecersiz_kategori`, `gecersiz_tarih`…) ya da bu uç deneme anahtarıyla kullanılamaz (`deneme_desteklenmiyor`).


```json
{
  "hata": "gecersiz_parametre",
  "detay": "Sayfa ve adet tam sayı olmalı.",
  "hata_ayrinti": {
    "kod": "gecersiz_parametre",
    "mesaj": "Sayfa ve adet tam sayı olmalı.",
    "taraf": "istemci",
    "kaynak": null,
    "tekrar_denenebilir": false,
    "tekrar_sn": null
  }
}
```

### 401 — Anahtar yok ya da geçersiz (`yetkisiz`).


```json
{
  "hata": "yetkisiz",
  "detay": "Geçerli X-API-Key başlığı gerekli (panel › API).",
  "hata_ayrinti": {
    "kod": "yetkisiz",
    "mesaj": "Geçerli X-API-Key başlığı gerekli (panel › API).",
    "taraf": "istemci",
    "kaynak": null,
    "tekrar_denenebilir": false,
    "tekrar_sn": null
  }
}
```

### 429 — Saatlik istek sınırı aşıldı (`hiz_siniri`); Retry-After başlığı sıfırlanmaya kalan saniyeyi verir.

Retry-After: `2311`

```json
{
  "hata": "hiz_siniri",
  "detay": "Saatlik istek sınırı aşıldı (600). Bir sonraki saatte tekrar deneyin.",
  "hata_ayrinti": {
    "kod": "hiz_siniri",
    "mesaj": "Saatlik istek sınırı aşıldı (600). Bir sonraki saatte tekrar deneyin.",
    "taraf": "istemci",
    "kaynak": null,
    "tekrar_denenebilir": true,
    "tekrar_sn": 2311
  }
}
```

### 500 — Beklenmeyen hata (`ic_hata`, taraf ulawk); kısa süre sonra yeniden deneyin.

Retry-After: `60`

```json
{
  "hata": "ic_hata",
  "detay": "Beklenmeyen bir hata oluştu; kısa süre sonra yeniden deneyin.",
  "hata_ayrinti": {
    "kod": "ic_hata",
    "mesaj": "Beklenmeyen bir hata oluştu; kısa süre sonra yeniden deneyin.",
    "taraf": "ulawk",
    "kaynak": null,
    "tekrar_denenebilir": true,
    "tekrar_sn": 60
  }
}
```

## İstek

```bash
curl "https://ulawk.com/api/v1/gazeteler/?adet=2" \
  -H "X-API-Key: ulk_DENEME_ANAHTARINIZ" \
  -H "X-API-Secret: ulsk_DENEME_GIZLI_ANAHTARINIZ"
```