Express.js ile basit bir REST API yazalım

Bu yazıda Node.js için bir web framework’ü olan Express.js i kullanarak basit bir rest api yazacağız. Ayrıca node.js in require keywordü yerine ES6 özelliği olan import’u kullanacağım.

Express.js Nedir ?

Express.js web uygulamaları ve API’lar geliştirmek için kullanılan bir javascript kütüphanesidir. Node.js runtime’ı üzerinde çalışır.

Node.js’in daha düşük seviye HTTP Api’larındansa daha kolay bir uygulama geliştirme imkanı sunar

Express.js vs Node.js Farkını daha önce bu yazıda yazmıştım : Express vs Node.js: Farkları Neler

Paketlerin kurulması

Öncelikle bilgisayarınızda Node.js kurulu olması gerekir. Ardından projeyi oluşturmak istediğiniz klasöre gidip yeni bir terminal açmanız lazım.

Yeni bir node projesi için aşağıdaki komutu yazıyoruz.

npm init -y

Bu komuttan sonra aşağıdaki sonuç gelmeli

npm init -y output console

Ardından express paketini kuruyoruz

npm i express

Şimdi ben projeyi vscode’da açmak için terminale code . yazıcam. siz istediğiniz kod editörde açabilirsiniz.

Package.json değişiklikleri

Şimdi package.json dosyasında es6 module kullanabilmek ve projeyi başlatabilmek için olarak birkaç değişiklik yapmamız lazım. Öncelikle aşağıdaki satırı ekleyin

  "type": "module"

Ardından script kısmını aşağıdaki gibi değiştirin.

"scripts": {
    "start": "node app.js"
  }

Package.json dosyasını son hali şu şekilde olmalı.
Not : Express versiyonu değişebilir

express.js package.json son hali

App.js dosyası oluşturma ve REST API yazma

  1. Projenin konumunda app.js dosyası oluşturun.
  2. Dosyayı açın
  3. En üstte import express from “express” komutu ile express’i import edin
  4. let app = express() satırı ile app değişkenimizi başlatalım. Bu app değişkeni tüm projede bize express’i kullanma imkanı sağlayan değişken.
  5. Aşağıdaki kod satırını da ekleyin ve app.js şimdilik şu şekilde görünmeli.
import express from "express"

let app = express()

app.get("/", (req, res) => {
  res.send("Hello World")
})

app.get kısmı ne yapıyor

Öncelikle app değişkenini üstte oluşturduk. O express’i bir araç olarak kullanmak için bir değişken. Ardından .get ekleyerek sunucumuza Http GET isteği geldiğinde çalışacak fonksiyonu ekleyeceğiz.

(req,res) kısmı yine express tarafından bize sağlanan api yazmayı kolaylaştıran araçlar. req sunucuya gelen istek (request) ile ilgili bilgi ve methodları içerirken, res ise bizim bu isteği cevaplarken kullanacağımız faydalı methodları içeriyor.

Bu app.get bir callback alıyor. Bu callback fonksiyonu için Arrow Function kullandım. Eğer Arrow Function hakkında bilginiz yoksa şu yazıya bakabilirsiniz : Arrow function nasıl kullanılır

Callback fonksiyonu içinde ise bize verilen res değişkenini kullanarak res.send() methodunu çağırıyoruz. Bunun aldığı argümanda ise “Hello World” gönderiyoruz.

Böylelikle bir kullanıcı bizim sunucumuza GET isteği attığında ona “Hello World” cevabı dönecek.

Sunucuyu çalıştırma

Son olarak kodumuza aşağıdaki satırları ekliyoruz ki express uygulaması bu Portu dinlesin

app.listen(3000, () => console.log("uygulama başladı"))

Kodun son hali şöyle olmalı

Sunucuyu çalıştırmak için projenin olduğu konumda terminale aşağıdaki komutu yazıyoruz.

npm start

Bu komuttan sonra konsolda uygulama başladı mesajını görmeniz lazım

Tarayıcıdan istek gönderme

HTTP Get isteği tarayıcıdan direkt gönderilebilen bir istek olduğu için bir tarayıcı açın ve aşağıdaki adrese gidin

http://localhost:3000

Eğer web sayfasında “Hello World” cevabını aldıysanız her şey çalıştı demektir. Bir problem olursa yorum atabilirsiniz.
Ayrıca bu adresten Express.js’in resmi türkçe dokümantasyonuna ulaşabilirsiniz : Express.js

1 thought on “Express.js ile basit bir REST API yazalım”

  1. Geri bildirim: Express.js ile Typescript kurulumu

Yorum bırakın

E-posta adresiniz yayınlanmayacak. Gerekli alanlar * ile işaretlenmişlerdir

Scroll to Top