API Öğrenmek Neden Değerli?

Bannerbear: "Veriyi gönder, reklam görselini al."

Bannerbear, API üzerinden şablonlardan görsel ve video üretiyor. Bir mağaza ürün adını, fotoğrafını ve fiyatını gönderir; kampanya görselleri otomatik hazırlanır.

• Fiyat sayfasındaki başlangıç paketi: aylık 49 $, 1.000 API kredisi.
• Kurucu Jon Yongfook gelişim hikâyesinde ürünü REST API olarak sunmaya geçtiğini ve aylık 10.000 $ tekrarlayan gelire ulaştığını anlatıyor.

Dersle bağlantısı: İsteği almak, alanları doğrulamak, sonucu döndürmek, kullanımı kaydetmek, API'yi belgelemek.
Siz ne yapabilirsiniz? Bir emlak ofisi için ilan görseli ya da bir kurs için kişiye özel sertifika üreten küçük bir servis.

PDFMonkey: "JSON gönder, PDF al."

PDFMonkey, tek bir REST API çağrısıyla rapor, fatura ve sertifika üretiyor. Paketlerinden ikisi (KDV hariç):

• Ayda 300 belge: 5 €
• Ayda 3.000 belge: 15 €

Örnek müşteri: Kursu bitiren 800 kişiye isimlerine özel sertifika hazırlayacak bir eğitim kurumu. İsimleri tek tek yazmak yerine verileri gönderir, belgeleri alır.
Dersle bağlantısı: REST, JSON, belgenin durumunu veritabanında tutmak, anlaşılır hata yanıtları, dokümantasyon.

Freelance: "İki sistemi birbirine bağlamak."

Upwork'teki bir hizmet ilanında bir geliştirici REST API, ödeme, CRM ve e-ticaret entegrasyonlarını 99 $, 199 $ ve 399 $ paketlerle sunuyor. Aynı ilanda API dokümantasyonu ayrıca +40 $.

Örnek müşteri isteği: "Mağazaya sipariş geldiğinde müşteri bilgisi CRM'e aktarılsın, çalışan aynı bilgiyi tekrar yazmasın."
Dokümantasyonun ayrı fiyatlandırılması "Bunu neden yazıyoruz?" sorusunun cevabı.

Freelance: "Postman koleksiyonumuz hazır, entegrasyonu yapacak kişi arıyoruz."

Bir Shopify entegrasyonu iş ilanında müşteri, siparişlerin API ile gönderim sağlayıcısına aktarılmasını ve gönderim durumunun Shopify'a geri gelmesini istiyor. Sağlayıcının endpoint'leri ve dokümantasyonu bir Postman koleksiyonu olarak veriliyor.

Derste açtığınız Postman, müşterinin işi tarif ederken kullandığı araçla aynı.

İBB Açık Veri Portalı: Şehrin verisi bir istek uzağınızda

İstanbul Büyükşehir Belediyesi, data.ibb.gov.tr üzerinden 565 veri setini hem indirilebilir dosya hem de API olarak sunuyor. Bunlar arasında ulaşım, otopark, su, çevre ve kültür verileri var. Portal standart bir REST API kullanıyor (CKAN):

GET https://data.ibb.gov.tr/api/3/action/package_search?q=otopark

En dikkat çekici örnek İSPARK web servisi. Anahtar gerektirmiyor ve otoparklardaki boş yer sayısını canlı veriyor:

GET https://api.ibb.gov.tr/ispark/ParkDetay?id=2338

[{ "parkName": "19 Mayıs Açık", "district": "ŞİŞLİ",
   "capacity": 65, "emptyCapacity": 19,
   "updateDate": "03.11.2026 15:45:01",
   "tariff": "0-1 Saat : 140,00;1-2 Saat : 180,00;...", ... }]

Kurum, servisin Türkçe ve İngilizce kullanım dokümanını da yayımlıyor. Bir geliştiricinin bu servisi kullanabilmesi için endpoint'in tek başına yetmediğini, dokümana da ihtiyaç olduğunu gösteriyor.

Dersle bağlantısı: Hafta 1'de yazdığınız HTTPX istemcisi bu adrese de aynı şekilde istek atabilir; yol ve sorgu parametreleri, JSON dizisi ve nesnesi de aynı. 12. haftada harici API kullanımı ve önbellek konusu için de hazır bir örnek: Boş yer sayısı birkaç dakikada bir değişiyor, her kullanıcı isteğinde İBB'ye tekrar sormak gerekir mi?
Siz ne yapabilirsiniz? "Gideceğim ilçede boş yeri olan en yakın otopark" servisi. Bunun için kendi API'niz İBB'den veriyi alır, filtreler ve sonucu kendi biçiminde döndürür.

Hürriyet Developers API: Bir API'nin yaşam döngüsü

Hürriyet 2016'da developers.hurriyet.com.tr adresinde bir geliştirici platformu açtı (Webrazzi haberi). Haberler, köşe yazıları, foto galeriler, kategoriler ve yazarlar REST API ile sunuluyordu. Yalnızca GET destekleniyordu, API anahtarı gerekiyordu, istek sınırları vardı. Platformda dokümantasyon ve deneme sayfası da bulunuyordu.

Şirketin hedefi, geliştiricilerin bu içerikle farklı haber uygulamaları yapmasıydı. Gerçekten de geliştiriciler bu API için Python, JavaScript, Ruby ve Haskell kütüphaneleri yazdı. İyi belgelenmiş bir API, sahibinin yazmadığı kodların ortaya çıkmasını sağlar.

Kasım 2026 itibarıyla ise developers.hurriyet.com.tr adresi artık açılmıyor. Bu kütüphanelerin ve onları kullanan uygulamaların bağlandığı servis yok.

Dersle bağlantısı: İki tarafı da görüyoruz. Sağlayıcı olarak: dokümantasyon ve API anahtarı (Hafta 9–13). Kullanıcı olarak: Başka birinin API'sine bağlıysanız, o servis yanıt vermediğinde uygulamanızın ne yapacağını önceden düşünmeniz gerekir (Hafta 12).