Modern yazılım dünyasında uygulamalar artık tek başına çalışmıyor. Farklı sistemler, servisler ve platformlar birbirleriyle sürekli veri alışverişi yapıyor. Bu iletişimi sağlayan temel teknoloji ise API olarak bilinir.

API'ler sayesinde bir uygulama başka bir uygulamadan veri alabilir, veri gönderebilir veya belirli işlemleri gerçekleştirebilir. Örneğin bir mobil uygulama hava durumu bilgilerini çekebilir, bir e-ticaret sitesi ödeme sistemleriyle entegre olabilir veya bir web sitesi sosyal medya hesaplarına içerik gönderebilir.

Bugün kullandığımız birçok dijital servis aslında arka planda API teknolojisi üzerine kuruludur.

Örneğin:

• ödeme sistemleri

• harita servisleri

• sosyal medya platformları

• hava durumu servisleri

• e-ticaret sistemleri

Bu rehberde API kavramını baştan sona öğreneceksiniz.

Bu yazıda şunları ele alacağız:

• API nedir

• API nasıl çalışır

• REST API nedir

• API türleri

• API endpoint nedir

• API request ve response yapısı

• API güvenliği

• API kullanım alanları

• API geliştirme mantığı

Eğer yazılım geliştiriciyseniz veya yazılım dünyasına girmek istiyorsanız API mantığını anlamak kritik bir beceridir.

API Nedir?

API, “Application Programming Interface” kelimelerinin kısaltmasıdır.

Türkçe anlamı Uygulama Programlama Arayüzüdür.

API, farklı yazılımların birbirleriyle iletişim kurmasını sağlayan bir arayüzdür.

Basit bir şekilde anlatmak gerekirse:

API, iki yazılım sistemi arasında veri alışverişi yapılmasını sağlayan bir köprüdür.

Örneğin bir hava durumu uygulaması düşünelim.

Bu uygulama hava durumu verilerini kendisi üretmez. Bunun yerine bir hava durumu servisinin API’sini kullanır.

Uygulama API’ye bir istek gönderir.

API ise şu verileri döndürür:

• sıcaklık

• nem oranı

• rüzgar hızı

• hava durumu durumu

Bu sayede uygulama kullanıcıya güncel hava durumu bilgisi gösterebilir.

API Nasıl Çalışır?

API’lerin çalışma mantığı oldukça basittir.

Temel olarak şu üç bileşenden oluşur:

• istemci (client)

• sunucu (server)

• API arayüzü

Süreç şu şekilde işler:

1. İstemci API’ye bir istek gönderir

2. Sunucu isteği işler

3. API sonuçları istemciye döndürür

Bu süreç genellikle HTTP protokolü üzerinden gerçekleşir.

Örneğin bir API isteği şu şekilde olabilir:

GET https://api.example.com/products

Sunucu şu şekilde bir cevap döndürebilir:

{
  "product": "Laptop",
  "price": 15000
}

Bu veri genellikle JSON formatında olur.

API Neden Önemlidir?

API teknolojisi modern yazılım mimarisinin temel taşlarından biridir.

API’ler sayesinde:

• uygulamalar birbirleriyle iletişim kurabilir

• servisler yeniden kullanılabilir

• yazılım geliştirme süreci hızlanır

• sistemler modüler hale gelir

Örneğin bir e-ticaret sitesi ödeme sistemi yazmak zorunda değildir.

Bunun yerine şu ödeme API’lerini kullanabilir:

• Stripe

• PayPal

Bu sayede ödeme altyapısı hazır şekilde kullanılabilir.

API Türleri

API’ler kullanım amaçlarına göre farklı kategorilere ayrılabilir.

En yaygın API türleri şunlardır:

Open API

Herkese açık API’lerdir.

Geliştiriciler bu API’leri kullanarak uygulama geliştirebilir.

Partner API

Belirli şirketler veya iş ortakları için oluşturulur.

Private API

Sadece şirket içi kullanım için geliştirilir.

Composite API

Birden fazla API isteğini tek bir çağrıda birleştirir.

REST API Nedir?

REST API, günümüzde en yaygın kullanılan API türlerinden biridir.

REST, “Representational State Transfer” anlamına gelir.

REST API, HTTP protokolü kullanarak veri alışverişi yapan bir API mimarisidir.

REST API şu özelliklere sahiptir:

• stateless yapı

• HTTP metodları kullanımı

• JSON veri formatı

• URL tabanlı endpoint yapısı

REST API özellikle web ve mobil uygulamalarda çok yaygın kullanılır.

REST API Nasıl Çalışır?

REST API HTTP metodları kullanarak çalışır.

En yaygın kullanılan metodlar şunlardır:

GET

Veri almak için kullanılır.

GET /users

POST

Yeni veri oluşturmak için kullanılır.

POST /users

PUT

Var olan veriyi güncellemek için kullanılır.

PUT /users/1

DELETE

Veriyi silmek için kullanılır.

DELETE /users/1

Bu metodlar REST API'nin temel yapı taşlarını oluşturur.

API Endpoint Nedir?

API endpoint, API'nin erişilebilen URL adresidir.

Her endpoint belirli bir veri veya işlem için kullanılır.

Örneğin:

/users
/products
/orders

Bu endpointler farklı veri setlerini temsil eder.

API Request Yapısı

Bir API isteği genellikle şu bileşenlerden oluşur:

• URL

• HTTP metod

• headers

• body

Örnek bir API isteği:

POST /api/users
Content-Type: application/json

{
"name": "Ali",
"age": 25
}

API Response Yapısı

Sunucu API isteğine bir cevap gönderir.

Bu cevap genellikle JSON formatındadır.

Örnek response:

{
"id": 10,
"name": "Ali",
"age": 25
}

JSON Nedir?

JSON, API veri alışverişinde en çok kullanılan veri formatıdır.

JSON şu avantajlara sahiptir:

• hafif veri formatı

• okunabilir yapı

• programlama dilleri ile uyumlu

JSON veri örneği:

{
"product": "Phone",
"price": 8000
}

API Güvenliği

API güvenliği modern uygulamalar için kritik öneme sahiptir.

En yaygın API güvenlik yöntemleri şunlardır:

API Key

Her kullanıcıya özel anahtar verilir.

OAuth

Kullanıcı yetkilendirme sistemi.

JWT

Token tabanlı kimlik doğrulama sistemi.

Rate Limiting

API kullanımını sınırlandırır.

API Rate Limit Nedir?

Rate limit, bir kullanıcının API’ye belirli süre içinde gönderebileceği istek sayısını sınırlar.

Örneğin:

• dakikada 100 istek

• saatte 1000 istek

Bu sistem sunucu yükünü kontrol altında tutar.

API Kullanım Alanları

API teknolojisi birçok farklı alanda kullanılır.

Mobil uygulamalar

Mobil uygulamalar backend sistemleriyle API üzerinden iletişim kurar.

Web uygulamaları

Frontend ve backend API aracılığıyla bağlanır.

Ödeme sistemleri

E-ticaret siteleri ödeme API'leri kullanır.

Harita servisleri

Harita uygulamaları şu servisleri kullanır:

• Google Maps

Sosyal medya

Sosyal medya platformları geliştiricilere API sunar.

Örneğin:

• Twitter API

API Nasıl Geliştirilir?

API geliştirme süreci genellikle şu adımlardan oluşur:

1. veri modeli oluşturma

2. endpoint belirleme

3. HTTP metodları tanımlama

4. güvenlik sistemi ekleme

5. test süreci

API geliştirme için kullanılan popüler backend teknolojileri:

• Node.js

• Python

• Java

• PHP

API Test Araçları

API geliştirme sırasında test yapmak önemlidir.

En popüler API test araçlarından biri:

• Postman

Postman sayesinde API istekleri kolayca test edilebilir.

API Geleceği

API teknolojisi günümüzde yazılım mimarisinin merkezinde yer alıyor.

Özellikle şu alanlarda API kullanımı hızla artmaktadır:

• mikroservis mimarisi

• SaaS platformları

• bulut servisleri

• yapay zeka servisleri

Modern uygulamalar giderek daha fazla API tabanlı sistemlere dönüşmektedir.

Sonuç

API teknolojisi modern yazılım geliştirme süreçlerinin temel taşlarından biridir.

API sayesinde farklı sistemler birbirleriyle iletişim kurabilir ve veri paylaşabilir.

Özetle:

• API uygulamalar arasında iletişim sağlar

• REST API en yaygın kullanılan API mimarisidir

• API’ler HTTP protokolü ile çalışır

• JSON veri formatı yaygın kullanılır

API mantığını anlamak yazılım geliştiriciler için büyük avantaj sağlar.