REST API Nedir? Modern Yazılımların Birbiriyle Konuşma Dili (2026 Rehberi)

Difficulty level

Intermediate

What readers will learn

Bu rehberi tamamladığınızda;

API ve REST kavramlarını,
İstemci (Client) ile Sunucu (Server) arasındaki iletişimi,
HTTP metodlarının görevlerini,
JSON veri formatını,
REST API istek ve yanıt yapısını,
HTTP durum kodlarını,
Kimlik doğrulama yöntemlerini,
REST API'nin gerçek projelerde nasıl kullanıldığını

öğrenmiş olacaksınız.

​

30 Saniyelik Özet​

Bugün kullandığımız neredeyse tüm dijital hizmetler arka planda API'ler sayesinde birbiriyle iletişim kurar. Bir hava durumu uygulamasının güncel verileri göstermesi, e-ticaret sitesinde kredi kartıyla ödeme yapılması veya mobil uygulamanın kullanıcı bilgilerini sunucudan alması REST API sayesinde gerçekleşir.

REST API, farklı yazılımların internet üzerinden güvenli ve standart bir şekilde veri alışverişi yapmasını sağlayan en yaygın iletişim mimarisidir. Günümüzde web uygulamalarından mobil yazılımlara, mikro servislerden yapay zekâ sistemlerine kadar sayısız teknolojinin temelini oluşturur.

Bu rehberde REST API'nin ne olduğunu, nasıl çalıştığını ve neden modern yazılım geliştirmenin vazgeçilmez parçalarından biri olduğunu adım adım öğreneceksiniz.

API Nedir?​

API (Application Programming Interface), iki farklı yazılımın belirli kurallar çerçevesinde birbiriyle iletişim kurmasını sağlayan bir arayüzdür.
Bunu günlük hayattan basit bir örnekle düşünelim.
Bir restorana gittiğinizde doğrudan mutfağa girmezsiniz. Siparişinizi garsona iletirsiniz. Garson siparişi mutfağa taşır, hazırlanan yemeği size getirir.

Bu örnekte;

• Siz istemciyi (Client),
• Garson API'yi,
• Mutfak ise sunucuyu (Server) temsil eder.

İstemci ile sunucu arasındaki tüm iletişim API üzerinden gerçekleşir.

Bilmeniz Gereken

API, veritabanına doğrudan erişim sağlamaz. İstemcinin hangi verilere erişebileceğini ve hangi işlemleri yapabileceğini kontrol eden güvenli bir katman görevi görür.

REST Nedir?​

REST (Representational State Transfer), 2000 yılında Roy Fielding tarafından tanımlanan bir yazılım mimarisi yaklaşımıdır.
REST, API geliştirirken uyulması gereken kuralları ve prensipleri tanımlar. Bu prensiplere uygun geliştirilen API'lere REST API adı verilir.

REST'in amacı;

• basit,
• ölçeklenebilir,
• bağımsız,
• performanslı

bir iletişim modeli oluşturmaktır.

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

Bir REST API iletişimi dört temel adımdan oluşur.

1. İstemci bir HTTP isteği gönderir.
2. Sunucu isteği işler.
3. Gerekli işlemleri gerçekleştirir.
4. Sonucu JSON formatında istemciye döndürür.

Basit akış şu şekildedir:

Kullanıcı

↓
Web Sitesi / Mobil Uygulama
↓
REST API
↓
Sunucu
↓
Veritabanı
↓
JSON Yanıtı
↓
Kullanıcı

Bu yapı sayesinde istemci ile veritabanı arasında doğrudan bağlantı kurulmaz. Tüm iletişim API üzerinden yönetilir.

Gerçek Hayattan Bir Örnek​

Bir hava durumu uygulaması açtığınızı düşünün.
Uygulama sizin bulunduğunuz konumu alır ve şu isteği gönderir:

GET /weather?city=Berlin

Sunucu isteği işler ve aşağıdaki gibi bir yanıt döndürür:

{
"city": "Berlin",
"temperature": 27,
"condition": "Sunny"
}

Mobil uygulama bu veriyi ekranda gösterir.
Aslında uygulama hava durumunu "bilmiyordur"; sadece API'den gelen veriyi kullanıcıya sunuyordur.

HTTP Metotları​

REST API'lerde yapılan işlemler HTTP metotlarıyla ifade edilir.

Metot	Görevi
GET	Veri okur
POST	Yeni veri oluşturur
PUT	Mevcut veriyi tamamen günceller
PATCH	Verinin belirli alanlarını günceller
DELETE	Veriyi siler

Örneğin;

GET /users

Tüm kullanıcıları getirir.

GET /users/15

15 numaralı kullanıcıyı getirir.

POST /users

Yeni kullanıcı oluşturur.

DELETE /users/15

15 numaralı kullanıcıyı siler.

Bilmeniz Gereken

REST API'de URL, erişmek istediğiniz kaynağı (Resource) temsil eder. Yapılacak işlemi ise HTTP metodu belirler.

Örneğin;

• /users → kullanıcı kaynağı
• GET → kullanıcıları listele
• POST → yeni kullanıcı oluştur

JSON Neden Kullanılır?​

REST API'lerin büyük çoğunluğu verileri JSON (JavaScript Object Notation) formatında gönderir.

JSON;

• okunması kolaydır,
• hafiftir,
• insanlar tarafından anlaşılabilir,
• hemen hemen tüm programlama dilleri tarafından desteklenir.

Örnek:

{
  "id": 25,
  "name": "Ahmet Yılmaz",
  "email": "[email protected]",
  "role": "Administrator"
}

Bu yapı sayesinde farklı teknolojiler ortak bir veri dili kullanarak iletişim kurabilir.

REST API'nin Avantajları​

REST API'nin bu kadar yaygın kullanılmasının önemli nedenleri vardır.

• Farklı platformlar arasında kolay entegrasyon sağlar.
• Mobil ve web uygulamaları aynı API'yi kullanabilir.
• Mikro servis mimarisine uygundur.
• Ölçeklenebilir sistemler geliştirmeyi kolaylaştırır.
• Bakımı ve geliştirilmesi daha pratiktir.
• Günümüzdeki bulut servislerinin büyük bölümü REST API desteği sunar.

REST API Nerelerde Kullanılır?​

REST API'ler farkında olmadan her gün kullandığımız birçok hizmetin arkasında çalışır.

Örneğin;

• E-ticaret sitelerinde ürün listeleme
• Bankacılık uygulamalarında hesap bilgileri
• Sosyal medya platformlarında gönderiler
• Hava durumu servisleri
• Harita uygulamaları
• Ödeme sistemleri
• Kargo takip servisleri
• Yapay zekâ servisleri (OpenAI, Gemini, Claude vb.)

Bir ChatGPT istemcisinin modele soru göndermesi bile REST API üzerinden gerçekleşir.

Sonuç​

REST API, modern yazılım dünyasının ortak iletişim dilidir. Farklı sistemlerin güvenli, standart ve ölçeklenebilir şekilde veri alışverişi yapmasını sağlar.
İster bir mobil uygulama geliştirin, ister bir e-ticaret sitesi kurun, ister yapay zekâ servislerini projenize entegre edin; büyük olasılıkla arka planda bir REST API ile çalışacaksınız.
Bu nedenle REST API mantığını anlamak, günümüz yazılım geliştiricileri için temel bir beceridir.