API Nedir, Ne İşe Yarar? Webhook Nedir? Farkları ve Örneklerle Anlatım

Kısa cevap: API (Application Programming Interface — Uygulama Programlama Arayüzü), iki yazılımın birbiriyle belirli kurallar çerçevesinde konuşmasını sağlayan arayüzdür. Bir uygulama, başka bir servisten veri ister veya ona bir iş yaptırır; API bu isteğin nasıl yapılacağını ve cevabın nasıl döneceğini tanımlar. Webhook ise tersi yönde çalışır: bir olay gerçekleştiğinde servisin sizin adresinize kendiliğinden haber göndermesidir.

API'yi Günlük Hayattan Bir Örnekle Anlamak

Bir restoranda mutfağa doğrudan girmezsiniz; siparişi garsona verirsiniz, garson mutfağa iletir ve yemeği size getirir. API garsondur: ne sipariş edebileceğinizi (menü = dokümantasyon), nasıl isteyeceğinizi ve ne alacağınızı belirler. Mutfağın (sistemin) içini bilmenize gerek yoktur.

API Ne İşe Yarar? Örnekler

• Bir e-ticaret sitesinin kargo firmasından takip bilgisini çekmesi,
• Web sitesindeki ödeme formunun ödeme kuruluşuna kart işlemi yaptırması,
• Bir uygulamanın döviz kuru veya hava durumu verisini alması,
• Bir otomasyonun ChatGPT API ile metin üretmesi (bkz. ChatGPT API Nedir?),
• Bir sunucu sağlayıcısında sunucuların API ile otomatik kurulması — Tayhost'ta ödeme sonrası sunucunuzun dakikalar içinde hazır olması bu sayede mümkündür.

REST API, İstek ve Cevap

Günümüzde en yaygın tür REST API'dir. Bir istek şu parçalardan oluşur:

Parça	Örnek	Anlamı
Adres (endpoint)	https://api.ornek.com/v1/siparisler	Hangi kaynağa erişildiği
Yöntem (method)	GET, POST, PUT, DELETE	Oku, oluştur, güncelle, sil
Başlıklar (headers)	Authorization: Bearer ...	Kimlik doğrulama ve format bilgisi
Gövde (body)	JSON veri	Gönderilen bilgi

Cevap genellikle JSON formatında gelir ve bir durum kodu içerir: 200 başarılı, 401 yetkisiz, 404 bulunamadı, 429 çok fazla istek, 500 sunucu hatası.

curl -H "Authorization: Bearer API_ANAHTARI" https://api.ornek.com/v1/siparisler/123

{ "id": 123, "durum": "kargoda", "takip_no": "AB123456789TR" }

JSON nedir? Verileri "anahtar": "değer" çiftleriyle düzenleyen, hem insanların hem programların kolayca okuyabildiği metin formatıdır. API'lerin ortak dilidir.

API Anahtarı (API Key) Nedir?

API anahtarı, isteği yapanın kim olduğunu doğrulayan gizli bir koddur; bir kapı kartı gibidir. Asla web sitesinin tarayıcıda çalışan koduna, mobil uygulamaya veya herkese açık depolara koyulmamalı; yalnızca sunucu tarafında, ortam değişkenlerinde saklanmalıdır.

Webhook Nedir?

API'de bilgi almak için siz sorarsınız ("Yeni sipariş var mı?"). Sürekli sormak (polling) hem yavaş hem israftır. Webhook'ta ise bir olay olduğunda karşı taraf size haber verir: "Yeni sipariş geldi, işte bilgileri." Bunun için servise, bildirimlerin gönderileceği bir URL verirsiniz.

API ile Webhook Arasındaki Fark

	API	Webhook
Yön	Siz istek atarsınız (pull)	Servis size gönderir (push)
Zamanlama	İstediğiniz zaman	Olay anında
Kullanım	Veri okumak, işlem yaptırmak	Olaylardan anında haberdar olmak
Örnek	"Sipariş 123'ün durumu ne?"	"Ödeme tamamlandı" bildirimi

İkisi genellikle birlikte kullanılır: webhook "ödeme tamamlandı" der, siz de API ile siparişin ayrıntılarını çekip faturayı kesersiniz.

Webhook Kullanmak İçin Neler Gerekir?

1. Herkese açık, HTTPS'li bir adres: Webhook'u karşılayacak bir sunucu (bilgisayarınız kapalıyken de açık olmalı).
2. Doğrulama: Gelen isteğin gerçekten ilgili servisten geldiğini imza (signature) veya gizli anahtarla kontrol etmek.
3. Hızlı cevap: Webhook'a kısa sürede 200 dönüp ağır işi arka planda yapmak; yoksa servis isteği tekrar gönderebilir.
4. Tekrar gelen olaylara dayanıklılık: Aynı bildirim iki kez gelebilir; işlemi iki kez yapmamak (idempotency).

Kod Yazmadan API ve Webhook Kullanmak

n8n gibi otomasyon araçları, Webhook düğümüyle size hazır bir URL verir ve HTTP Request düğümüyle herhangi bir API'yi çağırmanızı sağlar. Böylece "form doldurulunca CRM'e kaydet ve Telegram'a bildir" gibi akışları kod yazmadan kurabilirsiniz. Yapay zeka asistanlarının API'leri araç olarak kullanabilmesi için geliştirilen standart ise MCP'dir.

Webhook ve Otomasyonlarınız İçin Sunucu

Webhook'ların 7/24 ulaşılabilir, SSL'li bir adrese ihtiyacı vardır. Tayhost'ta n8n ve otomasyonlarınız için sunucuyu kurup alan adı ve SSL'i ayarlayarak çalışır hâlde teslim eden anahtar teslim bir seçenek bulunur.