# YCN Spor Verisi API v1

Üretim adresi: `https://f4medya.ycnyazilim.com/api/v1`

## Kimlik doğrulama

Her korumalı istekte anahtarı HTTP başlığıyla gönderin:

```http
Authorization: Bearer YCN_API_ANAHTARI
```

Alternatif olarak `X-API-Key` başlığı kullanılabilir. Anahtarı tarayıcı tarafındaki JavaScript koduna, mobil uygulama paketine veya herkese açık bir kaynak deposuna yazmayın. Çağrıları kendi sunucunuzdan yapın.

## Uç noktalar

| Yöntem | Adres | Kapsam |
|---|---|---|
| GET | `/organizasyonlar` | `competitions:read` |
| GET | `/organizasyon/aktif` | `competitions:read` |
| GET | `/fikstur/{organizasyon_id}?page=1&limit=50` | `matches:read` |
| GET | `/mac/{mac_id}` | `matches:read` |
| GET | `/puan-durumu/{organizasyon_id}` | `standings:read` |
| GET | `/takim/{takim_slug}` | `teams:read` |

## Yanıt biçimi

Başarılı yanıtlar `success`, `data` ve `meta` alanlarını içerir. Hatalar `error.code` ve Türkçe `error.message` alanlarıyla döner. Tarihler ISO 8601 veya veritabanı saat diliminde `YYYY-MM-DD HH:MM:SS` biçimindedir.

## Kota

Her yanıtta `X-RateLimit-Limit` ve `X-RateLimit-Remaining` başlıkları bulunur. Sınır aşılırsa `429 Too Many Requests` ve `Retry-After` döner.

## Sürümleme

Geriye dönük uyumsuz değişiklikler yeni ana sürüm altında yayınlanır. `v1` içindeki alanlar kaldırılmadan önce geçiş süresi duyurulur. Yeni, isteğe bağlı alanlar aynı sürüme eklenebilir.

## Veri ilkeleri

Yalnızca yönetim tarafından kamuya açılan maçlar API'de görünür. Gizlenen turlar, ileri tarihli yayınlar ve yayına kapatılmış maç ayrıntıları dışarı verilmez. Puan durumu resmîleşen ve puana etkisi açık olan sonuçlardan anlık hesaplanır.