API (Application Programming Interface), aslında bir sunucunun dış dünyaya açtığı uç noktalar (endpoints) kümesidir. Teknik olarak bir sözleşmedir; "Bana şu formatta veri gönderirsen, ben de sana bu formatta cevap veririm" der.
1. Teknik İşleyiş Mekanizması
Bir API etkileşimi genellikle HTTP/HTTPS protokolleri üzerinden yürür. Süreç şu dört ana bileşen etrafında döner:
- Endpoint (Uç Nokta): İşlemin yapılacağı URL adresidir. - Örn:
https://api.servis.com/v1/users - Method (Yöntem): Yapılacak işlemin türünü belirler (CRUD operasyonları). -
GET: Veri çekme. -POST: Yeni veri oluşturma. -PUT/PATCH: Mevcut veriyi güncelleme. -DELETE: Veriyi silme. - Headers (Başlıklar): İsteğin meta verileridir. API Key genellikle burada gönderilir. -
Authorization: Bearer YOUR_API_KEYveyax-api-key: YOUR_API_KEY - Body (Gövde): Sunucuya gönderilen asıl veri paketidir. Günümüzde standart olarak JSON formatı kullanılır.
Neden API Kullanıyoruz? (Decoupling)
Modern mimaride sistemler Decoupled (Birbirinden bağımsız) olmalıdır.
- Senin Frontend'in (React/Next.js) ve Backend'in (Node.js/Python) birbirinden farklı dillerde yazılmış olabilir.
- Bu iki farklı dünya arasındaki tek köprü API'dir. Frontend verinin nasıl saklandığını bilmez, Backend verinin nasıl görüntülendiğini umursamaz. Sadece ortak bir dilde (JSON/REST) API üzerinden konuşurlar.