API Nedir, Ne İşe Yarar ve Nasıl Kullanılır? (2026 Rehberi)

Telefonundaki hava durumu uygulaması sıcaklığı nereden biliyor? Bir alışveriş sitesine “Google ile giriş yap” diyebilmen, kargonun nerede olduğunu siteden görebilmen ya da ChatGPT’nin başka uygulamaların içinde çalışabilmesi aynı şeye dayanıyor: API. API (Application Programming Interface, Türkçesiyle uygulama programlama arayüzü), iki yazılımın birbirleriyle konuşabilmesi için belirlenmiş kurallar bütünü. Bu rehberde API’nin ne olduğunu, ne işe yaradığını ve nasıl kullanıldığını anlattık; ayrıca kendimiz de gerçek bir API’ye istek gönderip sonucunu adım adım gösterdik.

API nedir?

API, bir yazılımın başka bir yazılımdan bilgi istemesini ya da ona iş yaptırmasını sağlayan bir kapı. API test aracı Postman bunu farklı yazılım bileşenlerinin birbiriyle iletişim kurup veri alışverişi yapmasını sağlayan protokoller olarak tanımlıyor. Bu yapıda iki taraf birbirinin iç yapısını bilmek zorunda değil. İstek atan taraf sadece “neyi, hangi biçimde isteyeceğini” bilir; karşı taraf da cevabı önceden anlaşılmış bir formatta döner.

Mozilla’nın geliştirici belgeleri (MDN) bunu evdeki prize benzetiyor. Bir cihazı çalıştırmak için onu doğrudan elektrik hattına bağlamazsın, fişi prize takarsın. Priz, arkadaki karmaşık tesisatı senden saklayıp sana kullanması kolay, standart bir giriş verir. API de yazılım dünyasındaki priz gibi: arkada veritabanları, sunucular, yapay zekâ modelleri çalışır, sen yalnızca tanımlı adrese doğru biçimde istek gönderirsin.

Gündelik hayatta API’ye ihtiyaç duyduğun yerlerden birkaçı:

• Hava durumu uygulaması, ölçüm verisini bir meteoroloji servisinin API’sinden çeker.
• “Google ile giriş yap” butonu, sitenin Google’ın kimlik doğrulama API’sine bağlanmasıyla çalışır; şifren o siteye hiç gitmez.
• E-ticaret sitesindeki ödeme ekranı çoğu zaman bir ödeme kuruluşunun API’siyle konuşur, kart bilgisini mağaza değil ödeme altyapısı işler.
• Uçak bileti karşılaştırma siteleri, havayollarının fiyat ve uçuş bilgisini API’ler üzerinden toplar.
• Yapay zekâ destekli bir not uygulaması, metni özetlemek için arka planda OpenAI, Anthropic ya da Google’ın model API’sini çağırır.

API ne işe yarar?

API’nin asıl işi, her şeyi baştan yazma zorunluluğunu ortadan kaldırmak. Harita uygulaması yapan biri dünya haritasını sıfırdan çizmez, bir harita API’sine bağlanır. Yapay zekâ özelliği eklemek isteyen küçük bir girişim kendi dil modelini eğitmez, hazır bir modelin API’sini kullanır. Bunun pratikteki karşılıkları şöyle:

• Otomasyon: Elle yapılan tekrar eden işleri (rapor çekme, gönderi paylaşma, fatura kesme) programların kendi aralarında halletmesini sağlar.
• Entegrasyon: CRM, muhasebe, e-posta ve e-ticaret sistemleri gibi farklı araçları birbirine bağlar.
• Hız ve maliyet: Ödeme, harita, çeviri, yapay zekâ gibi altyapıları kurmak yerine hazır servisleri kiralarsın.
• Güvenlik: Dış dünyaya veritabanının tamamını değil, sadece izin verilen kısmını açarsın; erişim anahtar ve yetkiyle sınırlanır.
• Gelir: Şirketler kendi verilerini ve servislerini API ile başkalarına satabilir.

Son madde sanıldığından büyük bir pazar. Postman’ın 2025 State of the API anketine katılan 5.700 kişinin verilerine göre kurumların yüzde 82’si kendini bir ölçüde “API öncelikli” olarak tanımlıyor (2023’te bu oran yüzde 66’ydı), API kullanan kurumların yüzde 65’i de API’lerden gelir elde ediyor. Aynı ankette katılımcıların yaklaşık yarısı, yapay zekâ sistemlerinin izinsiz ya da aşırı API çağrısı yapmasından endişe ettiğini söylüyor (Nordic APIs analizi).

API nasıl çalışır?

API’lerin büyük çoğunluğu “istek ve yanıt” mantığıyla çalışır. Bir taraf (istemci) istek gönderir, diğer taraf (sunucu) isteği kontrol eder, işini yapar ve yanıt döner. Postman’ın anlatımına göre bir istekte genellikle şu parçalar bulunur:

Yanıt tarafında da bir durum kodu, başlıklar ve gövde bulunur. Gövde bugün çoğunlukla JSON biçimindedir; Red Hat, JSON’un hem insanların hem makinelerin okuyabildiği, dilden bağımsız bir format olduğu için REST API’lerde en yaygın biçim olduğunu belirtiyor. Durum kodu ise isteğin başına ne geldiğini tek bakışta söyler. En sık karşılaşacakların (MDN HTTP durum kodları listesinden):

API türleri

API’ler iki farklı açıdan sınıflandırılır: kime açık oldukları ve hangi mimariyle kuruldukları. Erişime göre üç tür var (Postman):

• Özel (private, iç) API: Bir şirketin kendi sistemlerini birbirine bağlar, dışarıya kapalıdır.
• Açık (public) API: Herkesin ya da kayıt olan geliştiricilerin kullanımına açıktır. Bazıları ücretsiz, bazıları ücretlidir.
• Partner API: Yalnızca anlaşmalı şirketlerin erişebildiği, kimlik doğrulamayla korunan API’lerdir.

Mimari açıdan en sık duyacağın isimler:

API nasıl kullanılır? (İlk isteği birlikte gönderelim)

API kullanmayı anlamanın en kolay yolu bir tane çağırmak. Bunun için anahtar istemeyen, ticari olmayan kullanım için ücretsiz olan Open-Meteo hava durumu API’sini seçtik. 20 Ekim 2026 akşamı İstanbul için kendimiz denedik; aşağıdaki adımlar ve çıktılar o denemeden.

https://api.open-meteo.com/v1/forecast?latitude=41.01&longitude=28.98&current=temperature_2m&timezone=Europe%2FIstanbul

curl "https://api.open-meteo.com/v1/forecast?latitude=41.01&longitude=28.98&current=temperature_2m&timezone=Europe%2FIstanbul"

{"latitude":41.02444,"longitude":28.940546,"timezone":"Europe/Istanbul",
 "current_units":{"time":"iso8601","interval":"seconds","temperature_2m":"°C"},
 "current":{"time":"2026-10-20T23:45","interval":900,"temperature_2m":14.3}}

API anahtarı nedir, nasıl alınır?

Open-Meteo herkese açık bir veri sunduğu için kim olduğunu sormadı. Ama yapay zekâ modelleri, ödeme sistemleri ya da sosyal medya hesapları gibi ücretli ya da kişisel veriye dokunan API’ler isteği kimin gönderdiğini bilmek ister. Bunun en yaygın yolu API anahtarı (API key): sana özel, uzun bir karakter dizisi. Her isteğe eklenir; servis hem seni tanır hem de kullanımını hesabına yazar. Anahtar yoksa ya da yanlışsa 401 hatası alırsın.

Örnek olarak Google’ın Gemini API’sinde anahtar almak birkaç tıklık iş. Google’ın hızlı başlangıç rehberine göre:

• Google AI Studio içindeki API anahtarları sayfasına Google hesabınla gir; yeni kullanıcılar için proje ve anahtar otomatik oluşturuluyor.
• Anahtarı kopyalayıp bilgisayarında GEMINI_API_KEY adlı bir ortam değişkenine kaydet.
• İsteği gönderirken anahtarı x-goog-api-key başlığıyla ekle. Rehberdeki örnek istek şöyle:

curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gemini-3.8-flash", "input": "Explain how AI works in a few words"}'

Model adları ve uç noktalar zamanla değişebiliyor; kopyalamadan önce dokümantasyondaki güncel hâline bakmak gerekiyor. Ücretli kullanıma geçmek ise istek sınırlarını artırıyor ve Google Cloud faturalandırması kurmayı gerektiriyor.

API anahtarını nasıl korursun?

API anahtarı, kredi kartı bilgisi gibi düşünülmeli: ele geçiren kişi senin hesabından istek atar, faturası sana gelir. OpenAI’ın API anahtarı güvenliği önerilerinden en önemlileri:

• Anahtarı kodun içine yazma, ortam değişkeninde ya da bir şifre yöneticisinde (secrets manager) tut.
• GitHub gibi kod depolarına asla yükleme; depo gizli olsa bile.
• Tarayıcıda ya da mobil uygulamada çalışan koda koyma; istekleri kendi sunucun üzerinden geçir.
• Herkes kendi anahtarını kullansın, anahtar paylaşma.
• Harcama limiti koy; uyarılar trafiği durdurmuyor, sabit limit durduruyor. Sızıntıdan şüphelenirsen anahtarı hemen yenile.

Kod yazmadan API kullanmak

API kullanmak için yazılımcı olmak şart değil. Bugün pek çok araç, API’leri sürükle bırak ekranlarla birbirine bağlamanı sağlıyor:

• Postman: İstekleri bir form doldurur gibi hazırlayıp gönderdiğin, yanıtları düzenli gösteren bir test aracı. API’yi ilk kez deneyecekler için en rahat başlangıç.
• Make ve Zapier: “Şu olunca bunu yap” mantığıyla uygulamaları bağlayan otomasyon platformları. Biz de Instagram paylaşımlarını bu şekilde otomatikleştirdik; süreci Claude ile Instagram otomasyonu rehberinde anlattık.
• n8n: Kendi sunucunda da çalıştırabildiğin, yapay zekâ adımları eklenebilen açık kaynak otomasyon aracı. Kurulumunu n8n nedir rehberinde bulabilirsin.
• Hazır HTTP modülleri: Make, n8n ve Google E-Tablolar eklentileri gibi araçlarda “HTTP isteği” modülüne adresi, yöntemi ve anahtarı girip istediğin API’yi çağırabilirsin.

Türkiye’den de kullanabileceğin örnekler var. Merkez Bankası’nın EVDS sistemi döviz kuru, faiz ve enflasyon gibi istatistikleri web servis üzerinden de sunuyor; milli yapay zekâ platformu EVREN’in ücretsiz API’sini de EVREN rehberimizde ele aldık.

Yapay zekâ API’leri, ChatGPT farkı ve MCP

En çok karıştırılan konu şu: ChatGPT Plus ya da Claude Pro aboneliği ile aynı şirketin API’si aynı şey değil. Abonelik, sohbet arayüzünü kullanman için aylık sabit ücret. API ise modeli kendi uygulamana, sitene ya da otomasyonuna bağlamanı sağlar ve genelde kullandığın kadar ödersin; ücret, işlenen metin miktarını ölçen “token” sayısına göre hesaplanır. Güncel fiyatlar için OpenAI, Anthropic ve Google Gemini fiyat sayfalarına bakabilirsin. Aboneliğin olması API kullanımını ücretsiz yapmaz; iki taraf ayrı faturalandırılır.

Yapay zekâ tarafında son dönemde sık duyduğun bir kavram da MCP (Model Context Protocol). MCP, Claude ve ChatGPT gibi yapay zekâ uygulamalarını dosyalara, veritabanlarına ve başka araçlara bağlamak için geliştirilmiş açık bir standart. Resmî sitesi MCP’yi yapay zekâ uygulamaları için bir USB-C girişine benzetiyor: her araç için ayrı bağlantı yazmak yerine tek bir standart kullanılıyor. MCP sunucuları da arka planda çoğu zaman o servislerin API’lerini çağırıyor; yani MCP, API’nin yerini almıyor, yapay zekânın API’leri daha kolay kullanmasını sağlıyor. Bu yapının günlük kullanıma yansıyan bir örneğini Sunra MCP yazımızda inceledik.

Sıkça Sorulan Sorular

Kaynaklar

1. What is an API? A Beginner’s Guide to APIs (Postman)
2. Introduction to web APIs (MDN Web Docs, Mozilla)
3. HTTP response status codes (MDN Web Docs, Mozilla)
4. What is a REST API? (Red Hat)
5. Weather Forecast API Documentation (Open-Meteo)
6. Gemini API quickstart (Google AI for Developers)
7. Best Practices for API Key Safety (OpenAI Help Center)
8. What is the Model Context Protocol (MCP)? (Model Context Protocol)
9. A Deep Dive Into the State of the API 2025 (Nordic APIs, 20 Ekim 2025)
10. Elektronik Veri Dağıtım Sistemi (EVDS) (Türkiye Cumhuriyet Merkez Bankası)

Daha fazla güncel gelişme: Günün tüm yapay zeka haberleri için Yapay Zeka Haberleri sayfamızı takip et.