REST API Nedir? Yeni Başlayanlar için Anlaşılır Rehber

Web geliştiriciliğine yeni başlayan çoğu kişinin kafasını karıştıran ilk kavramlardan biri REST API olur. “API nedir, REST ne demek, neden bu kadar çok yerde karşıma çıkıyor?” diye düşünüyorsanız, yalnız değilsiniz.

Bu yazıda, bir yazılımcının gözünden REST API kavramını sade bir dille anlatacağım. Teknik terimlerin içinde boğulmadan ama konuyu da yüzeysel geçmeden ilerleyeceğiz. Hadi başlayalım!

API Nedir?

Önce API kavramıyla başlayalım.
API (Application Programming Interface), bir uygulamanın diğer uygulamalarla konuşmasını sağlayan bir arabirimdir. Gerçek hayatta bunu bir garson gibi düşünebilirsiniz: Restorana gidersiniz, yemeğinizi garsona söylersiniz, o da mutfağa iletir ve siparişiniz geldiğinde size sunar.

Yani API, istemciyle (örneğin frontend) sunucu (örneğin backend) arasındaki iletişimi yöneten aracıdır.

Peki REST Ne Demek?

REST (Representational State Transfer), API tasarımı için kullanılan bir mimari yaklaşımdır. 2000’li yıllarda Roy Fielding tarafından tanımlanmıştır ve hâlâ en yaygın kullanılan standarttır.

REST’in temel amacı şudur:
✅ Kaynaklara erişim basit ve tutarlı yollarla yapılsın.
✅ HTTP metodları (GET, POST, PUT, DELETE) net bir şekilde kullanılsın.
✅ URL yapısı anlamlı olsun (/users/5 gibi).

Bu da geliştiricilere hem kullanım hem de bakım açısından büyük kolaylık sağlar.

REST API Örneği

Bir kullanıcı verisini almak için şu URL’i kullandığımızı düşünelim:

Bu istek, “ID’si 5 olan kullanıcıyı getir” anlamına gelir. REST API burada çok sade çalışır:

• GET: veri al

• POST: yeni veri oluştur

• PUT: veri güncelle

• DELETE: veri sil

Her biri HTTP protokolünün doğal parçasıdır. Bu da REST API’leri web ile entegre etmeyi kolaylaştırır.

REST API’yi Nerelerde Kullanırız?

• Mobil uygulamalar (Flutter, React Native)

• Frontend projeleri (React, Angular, Vue)

• Mikroservis mimarilerinde

• Üçüncü parti servis entegrasyonlarında (örneğin ödeme sistemleri, harita servisleri)

Kısacası modern bir uygulama geliştiriyorsanız REST API ile mutlaka tanışacaksınız.

REST API Kullanırken Dikkat Edilmesi Gerekenler

1. Anlamlı endpoint isimleri kullanın:
   /getAllUsers yerine /users yeterlidir.

2. Stateless yapıya sadık kalın:
   Her istek bağımsız olmalı. Sunucu, önceki isteği hatırlamamalı.

3. Doğru HTTP metodlarını tercih edin:
   POST yerine GET kullanmak gibi yanlışlardan kaçının.

4. Status code’ları doğru döndürün:
   Başarılı ise 200 OK, bulunamadıysa 404 Not Found gibi.

Sonuç

REST API, yazılımcılar için temel taşlardan biridir. Anlaması zor gibi görünse de, aslında oldukça doğal ve mantıklıdır. Yazılım dünyasında birçok araç, REST API’leri destekleyecek şekilde geliştiği için bu konuyu iyi kavramanız sizi çok farklı seviyelere taşıyabilir.

Umarım bu yazı, REST API kavramına dair zihninizdeki sis perdesini biraz olsun aralamıştır.
Eğer başka yazılım konularında da sade ve gerçek deneyime dayalı yazılar okumak isterseniz, takipte kalın!