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.

Čo je REST API a ako funguje? Sprievodca pre začiatočníkov | Skillmea

REST API Ne İşe Yarar?

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.

RESTful API: A Beginner’s Guide to Web APIs

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/25 kimliği 25 olan ürünü getirir.

  • POST /api/urunler yeni ürün oluşturur.

  • PUT /api/urunler/25 ilgili ürünün temsilini değiştirir.

  • PATCH /api/urunler/25 ürün bilgilerinin bir bölümünü günceller.

  • DELETE /api/urunler/25 ilgili ü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?

PrestaShop API for Front Applications and Integrations

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.

Send API requests and get response data in Postman | Postman Docs

Postman: HTTP istekleri oluşturmak, yanıtları incelemek ve API testleri hazırlamak için kullanılan bir araçtır.

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.

 


Alıntı