REST API Nedir ve Nasıl Yazılır?

Adı : REST API Nedir ve Nasıl Yazılır?

REST API, uygulama programlama arayüzü olarak bilinir ve web servislerinde kullanılan en popüler mimarilerden biridir. REST (Representational State Transfer) adından da anlaşılacağı gibi, kaynakları yönetmek için bir HTTP protokolü kullanır. Bu özellikleri sayesinde REST API, web uygulamalarının entegrasyonu, ölçeklenebilirliği ve verimliliği sağlamada son derece etkilidir.
REST API'nin temelleri
REST, bir istemci-sunucu modeli kullanır. Bu modelde, sunucu, temel olarak istekleri yanıtlayan ve yararlı bilgilerin depolandığı bir veritabanıdır. İstemci, sunucu ile bağlantı kurar ve ihtiyaçlarına göre verileri alır.
REST API, bir HTTP protokolü üzerinde çalışır. Bu, her isteğin bir HTTP yöntemi ve bir URI (Yaygın Kaynak Belirleyicisi) içermesi gerektiği anlamına gelir. HTTP yöntemi, sunucunun yapması gereken eylemi belirtirken URI, istenen kaynağı belirtir. Bu işlem sırasında, REST API de hata kodları (HTTP cevap kodları) gibi çeşitli bildirimler döndürebilir.
REST API, temel olarak türüne bağlı olarak dört tür istemci kodu içerir: GET, POST, PUT ve DELETE. GET, bir kaynağın değerlerini alırken, POST, yeni bir kaynak eklememize olanak tanır. PUT, mevcut bir kaynağı güncellerken DELETE, belirtilen kaynağı siler.
REST API'lerin faydaları
REST API, birçok fayda sağlar:
1. Esneklik ve ölçeklenebilirlik: REST API, uygulamaların düşük gereksinimler ve yüksek trafiği olan web uygulamaları gibi çevik hale getirilmesine yardımcı olur.
2. Daha az kaynak kullanımı: REST API, XML ve SOAP'a kıyasla daha hafif bir yapıda olduğu için, daha az kaynak kullanır.
3. Daha az bağımlılık: REST API, uygulamalar arasında bir dizi ortak veri biçimi veya doğrudan bağlantı olmaksızın iletişim kurduğu için, uygulamaların birbirine bağlılığı azaltır.
4. Kolay kullanım: REST API, birçok açık kaynaklı araçla birlikte gelir ve kullanmak için kolaydır.
REST Express.js kullanarak API yazmak
Java, Python ve C gibi birçok programlama dili, REST API'ler oluşturmak için kullanılabilir. Ancak, Express.js kullanarak REST API yazmak birçok geliştirici için daha kolay olabilir.
Express.js, Node.js tabanlı bir web uygulama çerçevesidir. Bu nedenle, Express.js kullanarak bir REST API oluşturmak, web uygulamalarındaki tüm olumlu özellikleri sunar. Ayrıca, bütünleştirme ve prototipleme süreçlerinde kolaylık sağlar.
1. İlk adım, bir Node.js yükleme gerektirir. Node.js web sitesinde mevcut olan Node.js kitaplığını indirip, yükleyin.
2. Daha sonra, Express.js kitaplığını indirin ve projenizde kullanın.
3. Projenizde bir app.js dosyası oluşturun ve aşağıdaki kodu ekleyin.
```
var express = require('express');
var app = express();

app.listen(3000, function () {
console.log('Rest api uygulama örneği dinlemede...');
});
```
4. Bu proje, yerel bilgisayarınızda 3000 numaralı bağlantı noktasını dinleyecektir. Projenin çalıştığından emin olmak için http://localhost:3000 adresini açın.
5. Şimdi, HTTP GET yöntemi aracılığıyla bir REST API oluşturabiliriz. Şu kodu uygulamamıza ekleyin:
```
app.get('/kullanici/:id?', function(request, response) {
if (request.params.id) {
response.json({
kullaniciId: parseInt(request.params.id),
ad: 'Ozan',
soyad: 'Demircan',
sehir: 'İstanbul'
});
} else {
response.json([
{
kullaniciId: 1,
ad: 'Ozan',
soyad: 'Demircan',
sehir: 'İstanbul'
},
{
kullaniciId: 2,
ad: 'Ferhat',
soyad: 'Demir',
sehir: 'Ankara'
}
]);
}
});
```
Bu örnekte localhost:3000/kullanici adresine giderek, id değeri belirtilmeden tüm kullanıcıların, belirtildiğinde ise belirlediğiniz kullanıcının bilgilerinin getirildiğini gösterir.
Buna ek olarak, HTTP POST, PUT ve DELETE yöntemlerini de kullanarak, veritabanına veri kaydedebilir, silebilir ve güncelleyebilirsiniz.
Sık sorulan sorular
1. REST API'lerin farklı tipleri nelerdir?
- REST API'ler, HAL (Hypertext Application Language), JSON (JavaScript Object Notation), XML gibi veri biçimlerinde olabilir.
2. REST API, SOAP'a göre neden daha popülerdir?
- REST API daha hafif ve daha ölçeklenebilir bir yapıya sahiptir. Ayrıca, bağımsız olan bir protokol kullandığı için daha az bağımlıdır.
3. REST API, web uygulamaları için neden önemlidir?
- REST API, uygulamaların daha entegre ve genişleyebilir bir yapıda olmasını sağlar. Ayrıca, uygulamalar arasındaki iletişimi kolaylaştırır ve verimliliği artırır.
4. REST API'ler için en popüler programlama dilleri nelerdir?
- Java, Python, C#, PHP, Ruby gibi programlama dilleri, REST API'ler oluşturmak için kullanılabilir.
5. REST API'lerin güvenliği nasıl sağlanır?
- REST API'lerde SSL (Güvenli Yuva Katmanı) teknolojisi kullanarak, verilerin şifrelenmesi ve güvenliğinin sağlanması mümkündür. Ayrıca, erişim kontrolleri de yapılabilir.