## TR Dizin Entegrasyonu Geliştirme Dokümanı – Veri Erişimi Yöntemi

Türkiye’nin en büyük kamu‑özel iş birliği veri platformu **TR Dizin**, kurumların ve geliştiricilerin veri setlerine güvenli ve standart bir şekilde erişmesini sağlayan bir API altyapısına sahiptir. Bu doküman, TR Dizin entegrasyonunu gerçekleştirmek isteyen yazılım ekiplerine adım adım rehberlik eder.

### 1. Entegrasyonun Temel Bileşenleri
- **API Anahtarı (API Key)**: TR Dizin’e kayıt olduğunuzda size özel bir anahtar verilir. Bu anahtar, tüm isteklerde `Authorization` başlığı içinde gönderilmelidir.
- **Endpoint URL**: Veri sorgulama, kayıt ve güncelleme işlemleri için kullanılan temel URL `https://api.trdizin.gov.tr/v1/` dir.
- **JSON‑Tabanlı İstek/ Yanıt**: Tüm veri alışverişi JSON formatında gerçekleşir; bu sayede modern web ve mobil uygulamalarla uyumluluk sağlanır.

### 2. Veri Erişimi Yöntemi
1. **Kimlik Doğrulama**
```http
GET /v1/auth/status HTTP/1.1
Host: api.trdizin.gov.tr
Authorization: Bearer {API_KEY}
```
Başarılı bir yanıt `200 OK` ve kimlik bilgilerini içerir.
2. **Veri Sorgulama**
- **Filtreleme**: `?category=education&year=2023` gibi parametrelerle veri seti daraltılabilir.
- **Sayfalama**: `?page=2&limit=50` ile büyük veri setleri parça parça çekilir.
```http
GET /v1/datasets/education?year=2023&page=1&limit=100 HTTP/1.1
Authorization: Bearer {API_KEY}
```
3. **Veri Gönderme (POST)**
```http
POST /v1/datasets/education HTTP/1.1
Content-Type: application/json
Authorization: Bearer {API_KEY}

{
"title": "Yeni Eğitim Projesi",
"description": "2024 yılı için planlanan proje...",
"year": 2024
}
```

### 3. Hata Yönetimi
| HTTP Kodu | Açıklama | Çözüm |
|-----------|----------|------|
| 400 | Geçersiz istek parametresi | Parametreleri kontrol edin |
| 401 | Yetkilendirme hatası | API anahtarını doğrulayın |
| 404 | Kaynak bulunamadı | Endpoint ve ID’yi kontrol edin |
| 500 | Sunucu hatası | Tekrar deneyin, destek ekibiyle iletişime geçin |

### 4. En İyi Uygulamalar
- **Cache Kullanımı**: Sık kullanılan sorgular için yerel cache (Redis, Memcached) uygulayın.
- **Rate Limiting**: TR Dizin, dakikada 60 istek limiti uygular; bu limiti aşmamak için istekleri kuyruğa alın.
- **Günlük Kayıt (Logging)**: Başarısız ve başarılı istekleri loglayarak sorunları hızlı tespit edin.

### 5. Destek ve Güncellemeler
TR Dizin dokümantasyonu, her çeyrekte yeni sürüm notlarıyla güncellenir. En son değişiklikleri takip etmek ve teknik destek almak için **TR Dizin Yardım** portalını ziyaret edin.

Bu rehber, geliştiricilerin TR Dizin API’sini güvenli, hızlı ve ölçeklenebilir bir şekilde entegre etmelerini sağlar. Uygulamanızda bu adımları izleyerek veri erişimini sorunsuz bir şekilde hayata geçirebilirsiniz.