REST API Nedir ve Nasıl Çalışır?
REST API (Representational State Transfer Application Programming Interface), web uygulamaları ve farklı yazılım sistemleri arasında veri alışverişi gerçekleştirmek için REST mimari ilkelerinden yararlanan bir uygulama programlama arayüzüdür.
REST, 2000 yılında Roy Fielding tarafından doktora tezinde tanımlanan bir yazılım mimarisi yaklaşımıdır. Özellikle dağıtık sistemlerin ve web servislerinin tasarımında kullanılmaktadır.
REST API'ler genellikle HTTP protokolü üzerinden çalışır. İstemciler, belirli kaynaklara erişmek veya bu kaynaklar üzerinde işlem gerçekleştirmek amacıyla sunucuya istek gönderir. Sunucu, gelen isteği değerlendirerek uygun HTTP durum kodu ve yanıtı oluşturur.
REST API'lerde JSON yaygın olarak kullanılan veri biçimlerinden biridir. Ancak REST mimarisi yalnızca JSON ile sınırlı değildir.
REST API, farklı uygulamaların ortak bir iletişim yapısı üzerinden veri almasını, göndermesini ve belirli işlemleri gerçekleştirmesini sağlar.
REST API'lerin başlıca kullanım amaçları şunlardır:
-
Veri alışverişi: Web siteleri, mobil uygulamalar ve sunucular arasında bilgi aktarımı sağlar.
-
Sistem entegrasyonu: Farklı yazılım sistemlerinin birlikte çalışmasını kolaylaştırır.
-
Veritabanı işlemleri: Yetkilendirilmiş istemcilerin sunucu aracılığıyla kayıt oluşturmasına, sorgulamasına, güncellemesine ve silmesine olanak tanır.
-
Mobil uygulama desteği: Android ve iOS uygulamalarının backend hizmetlerine erişmesini sağlar.
-
Otomasyon: Belirli işlemlerin uygulamalar arasında otomatik yürütülmesine yardımcı olur.
-
Merkezi hizmetler: Birden fazla istemcinin aynı sunucu hizmetlerini kullanmasını sağlar.
REST API Nasıl Çalışır?
REST API'lerde istemci ve sunucu arasında istek-yanıt iletişimi gerçekleşir.
1. İstemci İstek Gönderir
Bir web sitesi, mobil uygulama veya başka bir yazılım, belirli bir kaynağa erişmek için HTTP isteği gönderir.
Örneğin bir alışveriş uygulaması ürün listesini almak istediğinde ilgili API uç noktasına GET isteği gönderebilir.
2. Sunucu İsteği Karşılar
Sunucu, gelen HTTP isteğini değerlendirir. İstek yöntemi, hedef kaynak, gönderilen veriler ve gerekli erişim izinleri kontrol edilir.
3. Backend İşlemleri Gerçekleştirilir
Sunucu, istenen işlemi gerçekleştirmek için uygulamanın iş kurallarını çalıştırır.
Gerekli durumlarda veritabanına erişilir veya başka servislerle iletişim kurulur.
4. Sunucu Yanıt Oluşturur
İşlem tamamlandıktan sonra sunucu, HTTP durum kodu ve gerektiğinde yanıt gövdesi oluşturur.
Yanıt gövdesi JSON, XML veya farklı bir veri biçiminde olabilir.
5. İstemci Yanıtı İşler
İstemci, sunucudan gelen yanıtı değerlendirir ve gerekli işlemleri gerçekleştirir.
Örneğin alınan ürün bilgileri web sayfasında listelenebilir.
REST API'nin Temel Mimari İlkeleri
REST mimarisi belirli kısıtlamalar ve tasarım ilkeleri üzerine kuruludur.
İstemci-Sunucu Mimarisi
İstemci ve sunucu birbirinden ayrı sorumluluklara sahiptir.
İstemci kullanıcı etkileşimlerini yönetirken sunucu verilerin ve iş kurallarının yönetiminden sorumlu olabilir.
Durumsuzluk (Stateless)
REST mimarisinde her istemci isteği, sunucunun isteği anlayıp işleyebilmesi için gerekli bilgileri içermelidir.
Sunucu, önceki isteklere ait istemci oturum durumuna bağımlı olmadan yeni isteği işleyebilmelidir.
Önbelleğe Alınabilirlik (Cacheable)
REST yanıtları, uygun durumlarda önbelleğe alınabilecek şekilde tanımlanabilir.
Bu özellik, tekrar eden isteklerde ağ trafiğini ve sunucu yükünü azaltmaya yardımcı olabilir.
Tek Tip Arayüz (Uniform Interface)
REST mimarisinde kaynakların tanımlanması ve kaynaklar üzerinde işlem yapılması için tutarlı bir arayüz kullanılır.
Katmanlı Sistem (Layered System)
İstemci ile sunucu arasında yük dengeleyici, önbellek veya ağ geçidi gibi ara bileşenler bulunabilir.
İsteğe Bağlı Kod (Code on Demand)
REST mimarisinde isteğe bağlı olarak sunucudan istemciye çalıştırılabilir kod aktarılabilir.
Bu ilke zorunlu değildir.
REST API HTTP Metotları Nelerdir?
REST API'lerde kaynaklar üzerinde işlem gerçekleştirmek için standart HTTP yöntemleri kullanılır.
|
HTTP Metodu |
Kullanım amacı |
|---|---|
|
GET |
Kaynak bilgilerini almak |
|
POST |
Veri göndermek veya yeni kaynak oluşturmak |
|
PUT |
Kaynağı oluşturmak veya tamamen değiştirmek |
|
PATCH |
Kaynağı kısmen güncellemek |
|
DELETE |
Kaynağı silmek |
|
HEAD |
Yanıt gövdesi olmadan üst bilgileri almak |
|
OPTIONS |
Kaynak için desteklenen iletişim seçeneklerini öğrenmek |
HTTP yöntemlerinin doğru kullanılması, API'nin anlaşılabilirliğini ve tutarlılığını artırır.
REST API Endpoint Nedir?
Endpoint, bir API üzerinden belirli bir kaynağa veya işleve erişmek için kullanılan uç noktadır.
Örneğin bir ürün yönetim uygulamasında aşağıdaki yollar tanımlanabilir:
GET /api/urunler
GET /api/urunler/25
POST /api/urunler
PUT /api/urunler/25
PATCH /api/urunler/25
DELETE /api/urunler/25
Bu örnekte:
-
GET /api/urunlerürün listesini getirir. -
GET /api/urunler/25kimliği 25 olan ürünü getirir. -
POST /api/urunleryeni ürün oluşturur. -
PUT /api/urunler/25ilgili ürünün temsilini değiştirir. -
PATCH /api/urunler/25ürün bilgilerinin bir bölümünü günceller. -
DELETE /api/urunler/25ilgili ürünü siler.
Bunlar örnek uç noktalardır. Gerçek API'lerde yollar ve erişim kuralları uygulamaya göre değişebilir.
REST API ve JSON İlişkisi
JSON (JavaScript Object Notation), yapılandırılmış verilerin aktarılmasında kullanılan metin tabanlı bir veri biçimidir.
REST API'lerde JSON sıklıkla tercih edilir.
Örnek bir ürün bilgisi yanıtı:
{
"id": 25,
"urun_adi": "Kablosuz Mouse",
"fiyat": 450,
"stok": 18,
"aktif": true
}
Bu örnekte API, bir ürüne ait bilgileri JSON biçiminde sunmaktadır.
JSON, farklı programlama dilleri tarafından desteklendiği için web ve mobil uygulamalar arasında veri alışverişinde yaygın olarak kullanılır.
REST API HTTP Durum Kodları
REST API'lerde HTTP durum kodları, isteğin sonucunu istemciye bildirmek amacıyla kullanılır.
|
Durum kodu |
Anlamı |
|---|---|
|
200 OK |
İstek başarıyla işlendi |
|
201 Created |
Yeni kaynak oluşturuldu |
|
204 No Content |
İşlem başarılı, yanıt gövdesi yok |
|
400 Bad Request |
İstek hatalı |
|
401 Unauthorized |
Geçerli kimlik doğrulama bilgisi gerekli |
|
403 Forbidden |
İstenen işleme erişim yasak |
|
404 Not Found |
İstenen kaynak bulunamadı |
|
405 Method Not Allowed |
HTTP yöntemi desteklenmiyor |
|
409 Conflict |
İstek mevcut kaynak durumuyla çakışıyor |
|
429 Too Many Requests |
Çok fazla istek gönderildi |
|
500 Internal Server Error |
Sunucu tarafında beklenmeyen hata oluştu |
|
503 Service Unavailable |
Hizmet geçici olarak kullanılamıyor |
Durum kodlarının doğru kullanılması, istemcinin sunucu yanıtını değerlendirmesini kolaylaştırır.
REST API ile SOAP Arasındaki Farklar
REST ve SOAP, web servislerinde kullanılan farklı yaklaşımlardır.
|
Özellik |
REST |
SOAP |
|---|---|---|
|
Yapısı |
Mimari yaklaşım |
Mesajlaşma protokolü |
|
Veri biçimi |
JSON, XML ve diğer biçimler |
XML |
|
İletişim |
Genellikle HTTP |
HTTP ve farklı taşıma protokolleri |
|
Durum yönetimi |
Durumsuzluk temel ilkedir |
Durumlu veya durumsuz olabilir |
|
Standartlar |
REST mimari kısıtlamaları |
SOAP ve ilişkili standartlar |
|
Kullanım |
Web API'leri ve uygulama entegrasyonları |
Kurumsal ve standartlaştırılmış servis entegrasyonları |
Her iki yaklaşım da farklı sistemlerin iletişim kurmasını sağlayabilir. Kullanılacak yöntem, projenin teknik gereksinimlerine göre belirlenir.
REST API Nerelerde Kullanılır?
E-Ticaret Uygulamaları
Ürün listeleme, stok sorgulama, sipariş oluşturma ve müşteri bilgilerini yönetme işlemlerinde REST API kullanılabilir.
Mobil Uygulamalar
Mobil uygulamalar, kullanıcı bilgilerine ve sunucu hizmetlerine REST API aracılığıyla erişebilir.
Sosyal Medya Platformları
Yetkilendirilmiş uygulamalar, platformların sunduğu API'ler üzerinden belirli verilere ve işlevlere erişebilir.
Ödeme Sistemleri
Ödeme hizmeti sağlayıcıları, ödeme başlatma, işlem durumu sorgulama ve iade gibi işlevler için API hizmetleri sunabilir.
Kargo ve Lojistik Sistemleri
Kargo takip bilgileri, gönderi oluşturma ve teslimat durumlarının sorgulanması API'ler aracılığıyla gerçekleştirilebilir.
Kurumsal Yazılımlar
Muhasebe, müşteri ilişkileri yönetimi ve stok sistemleri arasında veri aktarımı için REST API'lerden yararlanılabilir.
REST API Güvenliği Nasıl Sağlanır?
REST API'lerde veri güvenliği ve erişim kontrolü önemli konular arasındadır.
Başlıca güvenlik önlemleri şunlardır:
-
HTTPS kullanarak iletişimi şifrelemek.
-
Kimlik doğrulama ve yetkilendirme kontrolleri gerçekleştirmek.
-
Kullanıcıların yalnızca izin verilen kaynaklara erişmesini sağlamak.
-
Gelen verileri sunucu tarafında doğrulamak.
-
SQL Injection gibi saldırılara karşı parametreli sorgular kullanmak.
-
İstek sınırlandırma mekanizmaları uygulamak.
-
Gizli anahtarları güvenli ortamlarda saklamak.
-
Yazılım bileşenlerini güncel tutmak.
-
Hassas verileri hata mesajlarında paylaşmamak.
REST mimarisinin kullanılması tek başına güvenli bir API oluşturulduğu anlamına gelmez. Güvenlik önlemleri ayrıca tasarlanmalı ve uygulanmalıdır.
REST API Geliştirmek İçin Hangi Teknolojiler Kullanılır?
REST API geliştirmek için farklı programlama dilleri ve framework'ler kullanılabilir.
|
Programlama dili |
Framework veya araç |
|---|---|
|
PHP |
Laravel, Symfony |
|
Python |
FastAPI, Django REST Framework |
|
JavaScript |
Express, NestJS |
|
Java |
Spring Boot |
|
C# |
ASP.NET Core |
|
Go |
Gin, Echo |
REST API'ler farklı programlama dilleriyle geliştirilebildiği gibi farklı teknolojiler kullanan istemciler tarafından da tüketilebilir.
REST API Test Araçları Nelerdir?
REST API geliştirme sürecinde isteklerin ve yanıtların kontrol edilmesi için çeşitli araçlar kullanılabilir.
Insomnia: API isteklerinin hazırlanmasını ve test edilmesini sağlayan bir geliştirme aracıdır.
cURL: Komut satırından HTTP istekleri göndermek için kullanılabilir.
Swagger UI: OpenAPI tanımlarına dayalı API belgelerinin görüntülenmesini ve uygun yapılandırmalarda isteklerin denenmesini sağlar.
Bu araçlar aracılığıyla HTTP yöntemleri, istek başlıkları, gönderilen veriler, yanıt gövdeleri ve durum kodları incelenebilir.
REST API Kullanmanın Avantajları
REST API mimarisinin sağladığı başlıca avantajlar şunlardır:
-
Standart HTTP yöntemlerinden yararlanılması.
-
İstemci ve sunucu sorumluluklarının ayrılması.
-
Farklı platformlarla iletişim kurulabilmesi.
-
Önbellekleme mekanizmalarının kullanılabilmesi.
-
Durumsuz iletişim sayesinde ölçeklendirmeyi kolaylaştırabilmesi.
-
Kaynak odaklı ve tutarlı API tasarımına olanak sağlaması.
-
Farklı programlama dilleriyle kullanılabilmesi.
REST API'lerin performansı ve ölçeklenebilirliği, mimari ilkelerin yanında sunucu altyapısına ve uygulama tasarımına da bağlıdır.
REST API ile RESTful API Aynı Şey midir?
REST API ve RESTful API ifadeleri günlük yazılım geliştirme kullanımında çoğunlukla birbirinin yerine kullanılır.
RESTful ifadesi, REST mimari ilkelerine uygun olarak tasarlanmış bir API'yi tanımlamak için kullanılır.
Ancak yalnızca HTTP üzerinden JSON verisi sunan veya GET ve POST yöntemlerini kullanan her API'nin bütün REST ilkelerine uyduğu söylenemez.
REST mimarisinde kaynakların tanımlanması, durumsuzluk, tek tip arayüz, önbelleğe alınabilirlik ve diğer mimari kısıtlamalar önemlidir.
Sonuç
REST API, farklı yazılım sistemlerinin HTTP üzerinden kaynaklara erişmesini ve bu kaynaklar üzerinde işlem gerçekleştirmesini sağlayan REST mimarisine dayalı bir uygulama programlama arayüzüdür.
Web siteleri, mobil uygulamalar, e-ticaret sistemleri ve kurumsal yazılımlar arasında veri alışverişi gerçekleştirmek için yaygın olarak kullanılmaktadır.
HTTP yöntemleri, durum kodları, kaynak tanımlayıcıları ve REST mimari ilkeleri, bu sistemlerin tutarlı biçimde geliştirilmesinde önemli rol oynar.







