## İYS API Dokümantasyonu – Hızlı ve Güvenli Entegrasyon

İYS (İletişim Yönetim Sistemi) API, kamu kurum ve kuruluşlarının vatandaşlarla etkili iletişim kurmasını sağlayan bir platformun programlama arayüzüdür. Bu API, SMS, e‑posta, push bildirimleri ve diğer iletişim kanallarını tek bir noktadan yönetmeye olanak tanır. **https://apidocs.iys.org.tr** adresindeki dokümantasyon, geliştiricilere API’nin tüm uç noktalarını, istek‑yanıt formatlarını ve güvenlik mekanizmalarını ayrıntılı bir şekilde sunar.

### Temel Özellikler
- **RESTful Mimari**: JSON tabanlı istek ve yanıtlar, HTTP metodları (GET, POST, PUT, DELETE) ile uyumludur.
- **OAuth 2.0 Yetkilendirme**: Güçlü token‑tabanlı kimlik doğrulama, her isteğin güvenliğini garanti eder.
- **Çoklu Kanal Desteği**: SMS, e‑posta, push ve sesli mesajlaşma gibi farklı iletişim kanallarına tek bir API üzerinden erişim.
- **Rate‑Limit ve İzleme**: Performans ve güvenlik için istek sınırları ve detaylı loglama.
- **Sandbox Ortamı**: Gerçek ortamda test yapmadan önce entegrasyonları doğrulamak için izole bir test ortamı.

### Entegrasyon Adımları
1. **Uygulama Kaydı**: İYS portalında bir uygulama oluşturup client‑id ve client‑secret alın.
2. **Token Alımı**: OAuth 2.0 token endpoint’ine `client_id` ve `client_secret` göndererek erişim token’ı alın.
3. **İstek Oluşturma**: İlgili uç noktaya (ör. `/messages/sms`) gerekli parametreleri (telefon numarası, mesaj içeriği, gönderim zamanı) ekleyerek POST isteği gönderin.
4. **Yanıt ve Hata Yönetimi**: Başarılı yanıtlar 200‑299 kodlarıyla döner; hata durumları (4xx, 5xx) dokümantasyonda tanımlı hata kodlarıyla açıklanır.
5. **Raporlama**: `/reports` endpoint’i üzerinden gönderilen mesajların durumunu, teslim raporlarını ve geri dönüşleri izleyin.

### Neden İYS API?
- **Yasal Uyum**: Türkiye’deki veri koruma ve iletişim mevzuatına tam uyum.
- **Ölçeklenebilirlik**: Yüksek hacimli kampanyalar için otomatik ölçeklendirme.
- **Güvenlik**: TLS 1.2+ şifreleme, token revocation ve IP‑whitelisting.
- **Destek ve Topluluk**: Resmi destek kanalları ve aktif geliştirici forumları.

Bu dokümantasyon, API’nin tüm fonksiyonlarını örnek kod parçacıkları (cURL, Python, Java) ile birlikte sunar. Geliştiriciler, hızlı prototipleme ve üretim ortamına geçiş için adım‑adım rehberlerden faydalanabilir.

---

### Sonuç
İYS API, kamu iletişimini dijitalleştirirken güvenli, ölçeklenebilir ve standart bir çözüm sunar. Doğru entegrasyon adımlarını izleyerek kurumlar, vatandaşlara zamanında ve etkili mesajlar gönderebilir, kampanya yönetimini merkezi bir panelden kontrol edebilir.