REST API, kullanıcılar, problemler veya siparişler gibi kaynaklar etrafında bir web API tasarlamanın yaygın bir yoludur. Her kaynağın bir URL’si olur ve GET, POST, PATCH ve DELETE gibi HTTP yöntemleri istemcinin sunucudan ne yapmasını istediğini belirtir.

REST, Representational State Transfer anlamına gelir. Pratikte istemci bir HTTP isteği gönderir, sunucu bir kaynağın temsilini döndürür ve her isteğin kendi başına anlamlı olması gerekir. Birçok REST API JSON döndürür, ancak tek başına JSON kullanmak bir API’yi RESTful yapmaz.

REST API Ne Demek: Kaynaklar Üzerinden Düşünün

REST’i anlamanın en hızlı yolu, fiillerle değil isimlerle düşünmektir.

Sisteminizde problemler, öğrenciler ve denemeler varsa, bunlar kaynak olabilir. Kaynak odaklı bir API genellikle /api/problems/42 veya /api/attempts/9001 gibi URL’ler kullanır.

HTTP yöntemi ise hangi tür işlemin yapıldığını söyler:

  • GET bir kaynağı okur
  • POST yeni bir kaynak oluşturur
  • PUT bir kaynağın tamamını değiştirir
  • PATCH bir kaynağın bir bölümünü günceller
  • DELETE bir kaynağı siler

REST’i hızlıca okunabilir yapan şey bu ayrımdır. URL, neyle çalıştığınızı söyler. Yöntem ise ne yapmak istediğinizi söyler.

Bir REST API İsteği Nasıl Çalışır?

Tipik bir akışta tarayıcı, mobil uygulama veya başka bir servis sunucuya bir istek gönderir. Bu istek bir URL, bir HTTP yöntemi, isteğe bağlı başlıklar ve bazen de bir gövde içerir.

Sunucu isteği okur, işlemi gerçekleştirir ve bir yanıt döndürür. Bu yanıt genellikle 200 OK, 201 Created veya 404 Not Found gibi bir durum kodu ve sonucun ne olduğunu açıklayan veriler içerir.

Önemli koşullardan biri statelessness yani durumsuzluktur. REST’te her istek, o isteğin işlenmesi için gereken bağlamı içermelidir. Bu, sunucunun hiç veri tutmadığı anlamına gelmez. Anlamı şudur: Sunucu, mevcut isteği anlamak için önceki isteklerden kalan gizli bir konuşma durumuna ihtiyaç duymamalıdır.

REST API Örneği: Bir Matematik Alıştırma Uygulaması

Bir matematik alıştırma uygulamasının cebir problemlerini ve öğrenci denemelerini sakladığını düşünün.

4242 numaralı problemi okumak için istemci şu isteği gönderebilir:

Bir soruyla yardıma mı ihtiyacın var?

Sorunuzu yükleyin ve saniyeler içinde doğrulanmış adım adım çözüm alın.

GPAI Solver Aç →