G\u00fcn\u00fcm\u00fcz\u00fcn dijital d\u00fcnyas\u0131nda uygulamalar aras\u0131 kesintisiz ileti\u015fim, ba\u015far\u0131l\u0131 projelerin temelini olu\u015fturur. Bu makale, modern web servis tasar\u0131m\u0131n\u0131n kalbi olan REST API’nin temel prensiplerini, mimarisini ve ad\u0131m ad\u0131m nas\u0131l uygulanaca\u011f\u0131n\u0131 a\u00e7\u0131kl\u0131yor, en iyi uygulamalar\u0131 ve ger\u00e7ek d\u00fcnya senaryolar\u0131n\u0131 ele al\u0131yor.<\/p>\n
Modern web ve mobil uygulamalar, kullan\u0131c\u0131 deneyimini zenginle\u015ftirmek i\u00e7in s\u00fcrekli olarak veri al\u0131\u015fveri\u015fi yapmak zorundad\u0131r. Peki, farkl\u0131 platformlar ve teknolojiler bu veri al\u0131\u015fveri\u015fini nas\u0131l standardize eder ve sorunsuz bir \u015fekilde ger\u00e7ekle\u015ftirir? \u0130\u015fte tam bu noktada, Representational State Transfer (REST)<\/a> mimarisi devreye girer. REST, web servisleri tasarlamak i\u00e7in bir dizi ilke ve k\u0131s\u0131tlama sunan, yaz\u0131l\u0131m mimari bir stilidir. RESTful API olarak adland\u0131r\u0131lan bu servisler, uygulamalar\u0131n internet \u00fczerinden birbirleriyle konu\u015fmas\u0131n\u0131 sa\u011flayan bir k\u00f6pr\u00fc g\u00f6revi g\u00f6r\u00fcr. Ba\u015fka bir deyi\u015fle, bir uygulaman\u0131n di\u011fer bir uygulamadan belirli bir veri par\u00e7as\u0131n\u0131 istemesi veya ona bir veri g\u00f6ndermesi gerekti\u011finde kullan\u0131lan standart bir ileti\u015fim yoludur.<\/p>\n REST’in temelini, web’in de \u00fczerinde \u00e7al\u0131\u015ft\u0131\u011f\u0131 HTTP protokol\u00fc olu\u015fturur. Bu, REST API’lerinin web taray\u0131c\u0131lar\u0131n\u0131n, mobil uygulamalar\u0131n, IoT cihazlar\u0131n\u0131n ve hatta di\u011fer sunucu taraf\u0131 uygulamalar\u0131n birbirleriyle tutarl\u0131 ve tahmin edilebilir bir \u015fekilde etkile\u015fim kurabilmesini sa\u011flar. REST mimarisi, kaynaklara (resources) odaklan\u0131r ve bu kaynaklar\u0131n standartla\u015ft\u0131r\u0131lm\u0131\u015f bir \u015fekilde temsil edilmesini sa\u011flar. \u00d6rne\u011fin, bir e-ticaret uygulamas\u0131nda “\u00fcr\u00fcnler” veya “m\u00fc\u015fteriler” birer kaynak olabilir. Bu kaynaklara, benzersiz URI’ler (Uniform Resource Identifiers) arac\u0131l\u0131\u011f\u0131yla eri\u015filir ve bu eri\u015fim HTTP metotlar\u0131 (GET, POST, PUT, DELETE) kullan\u0131larak ger\u00e7ekle\u015ftirilir. Bu temel prensipler, REST API’lerini son derece esnek, \u00f6l\u00e7eklenebilir ve platformdan ba\u011f\u0131ms\u0131z k\u0131lar.<\/p>\n REST’in bu kadar pop\u00fcler olmas\u0131n\u0131n ard\u0131nda yatan bir di\u011fer \u00f6nemli neden ise “durum bilgisizli\u011fi” (statelessness) ilkesidir. Bu ilke, her iste\u011fin sunucu taraf\u0131ndan i\u015flenmesi i\u00e7in gerekli t\u00fcm bilgileri i\u00e7ermesi gerekti\u011fi anlam\u0131na gelir. Sunucu, istemciden gelen \u00f6nceki isteklerle ilgili hi\u00e7bir bilgiyi saklamaz. Bu yakla\u015f\u0131m, API’nin kolayca \u00f6l\u00e7eklenmesine olanak tan\u0131r, zira sunucular her iste\u011fi ba\u011f\u0131ms\u0131z olarak i\u015fleyebilir ve farkl\u0131 sunucular aras\u0131nda y\u00fck da\u011f\u0131l\u0131m\u0131 yapmak daha kolay hale gelir. Ayr\u0131ca, \u00f6nbelleklenebilirlik (cacheability) de \u00f6nemli bir \u00f6zelliktir; sunucu yan\u0131tlar\u0131 istemci taraf\u0131nda veya ara katmanlarda \u00f6nbelle\u011fe al\u0131narak performans\u0131 art\u0131rabilir ve sunucu y\u00fck\u00fcn\u00fc azaltabilir. B\u00f6ylece, kullan\u0131c\u0131lar daha h\u0131zl\u0131 ve ak\u0131c\u0131 bir deneyim ya\u015farlar.<\/p>\n G\u00fcn\u00fcm\u00fcz\u00fcn mikroservis mimarilerinin ve bulut tabanl\u0131 uygulamalar\u0131n y\u00fckseli\u015fiyle birlikte, REST API’ler neredeyse her yaz\u0131l\u0131m projesinin ayr\u0131lmaz bir par\u00e7as\u0131 haline gelmi\u015ftir. Bu sayede farkl\u0131 ekipler birbirinden ba\u011f\u0131ms\u0131z servisler geli\u015ftirebilir ve bunlar\u0131 standart bir aray\u00fcz \u00fczerinden birle\u015ftirebilir. Bu esneklik, geli\u015ftirme s\u00fcre\u00e7lerini h\u0131zland\u0131r\u0131r, hata ay\u0131klamay\u0131 kolayla\u015ft\u0131r\u0131r ve genel olarak daha sa\u011flam sistemlerin in\u015fa edilmesine olanak tan\u0131r. Dolay\u0131s\u0131yla, bir yaz\u0131l\u0131m geli\u015ftiricisi olarak REST API’lerini anlamak ve etkin bir \u015fekilde tasarlayabilmek, modern web geli\u015fimindeki ba\u015far\u0131n\u0131z i\u00e7in kritik bir \u00f6neme sahiptir.<\/p>\n Etkili bir RESTful API tasarlamak, sadece fonksiyonel olmakla kalmay\u0131p, ayn\u0131 zamanda kolay anla\u015f\u0131l\u0131r, s\u00fcrd\u00fcr\u00fclebilir ve esnek olmal\u0131d\u0131r. Bu, belirli prensiplere ve en iyi uygulamalara ba\u011fl\u0131 kalarak ba\u015far\u0131labilir. \u0130lk ad\u0131m, API’nizin sunaca\u011f\u0131 “kaynaklar\u0131” do\u011fru bir \u015fekilde tan\u0131mlamakt\u0131r. Her kaynak, sisteminizde benzersiz bir veri par\u00e7as\u0131n\u0131 veya bir veri koleksiyonunu temsil etmelidir. \u00d6rne\u011fin, bir blog uygulamas\u0131nda “makaleler”, “kullan\u0131c\u0131lar” veya “yorumlar” birer kaynak olabilir.<\/p>\n Kaynaklara eri\u015fim, URI’ler (Uniform Resource Identifiers)<\/a> arac\u0131l\u0131\u011f\u0131yla sa\u011flan\u0131r. URI’ler, kaynaklar\u0131 a\u00e7\u0131k ve sezgisel bir \u015fekilde adland\u0131rmal\u0131d\u0131r. Genellikle kaynak adlar\u0131 \u00e7o\u011ful halde kullan\u0131l\u0131r ve hiyerar\u015fik bir yap\u0131 izler. \u00d6rne\u011fin:<\/p>\n Bu yakla\u015f\u0131m, API’nizin yap\u0131s\u0131n\u0131 tek bak\u0131\u015fta anlamay\u0131 kolayla\u015ft\u0131r\u0131r ve geli\u015ftiricilerin API’nizi daha h\u0131zl\u0131 benimsemesine yard\u0131mc\u0131 olur.<\/p>\n RESTful API’lerin kalbinde HTTP metotlar\u0131n\u0131n do\u011fru kullan\u0131m\u0131 yatar. Her bir HTTP metodu, kaynak \u00fczerinde belirli bir i\u015flemi (CRUD – Create, Read, Update, Delete) temsil eder:<\/p>\n API’niz her iste\u011fe anlaml\u0131 bir HTTP durum kodu ile yan\u0131t vermelidir. Bu kodlar, istemcinin iste\u011finin ba\u015far\u0131l\u0131 olup olmad\u0131\u011f\u0131n\u0131 veya hangi t\u00fcr bir sorunla kar\u015f\u0131la\u015ft\u0131\u011f\u0131n\u0131 anlamas\u0131na yard\u0131mc\u0131 olur. Ba\u015fl\u0131ca durum kodlar\u0131 \u015funlard\u0131r:<\/p>\n API g\u00fcvenli\u011fi, hassas verileri korumak ve yetkisiz eri\u015fimi engellemek i\u00e7in hayati \u00f6nem ta\u015f\u0131r. \u0130\u015fte baz\u0131 kritik g\u00fcvenlik \u00f6nlemleri:<\/p>\n Bu prensiplere ba\u011fl\u0131 kalarak tasarlanan bir API, hem geli\u015ftiriciler i\u00e7in kullan\u0131m\u0131 kolay olacak hem de sisteminizin uzun vadeli ba\u015far\u0131s\u0131n\u0131 destekleyecektir. \u0130yi bir API tasar\u0131m\u0131, sadece teknik bir gereklilik de\u011fil, ayn\u0131 zamanda geli\u015ftirici deneyimini art\u0131ran bir yat\u0131r\u0131m olarak g\u00f6r\u00fclmelidir.<\/p>\n \u015eimdiye kadar REST API’nin teorik temellerini ve tasar\u0131m prensiplerini ele ald\u0131k. Peki, bir REST API’yi ger\u00e7ekten nas\u0131l geli\u015ftiririz? Bu b\u00f6l\u00fcmde, basit bir “\u00dcr\u00fcn Katalo\u011fu” API’si \u00f6rne\u011fi \u00fczerinden ad\u0131m ad\u0131m bir uygulama geli\u015ftirece\u011fiz. Bu uygulama, \u00fcr\u00fcnleri listeleme, detaylar\u0131n\u0131 g\u00f6r\u00fcnt\u00fcleme, yeni \u00fcr\u00fcn ekleme, g\u00fcncelleme ve silme gibi temel CRUD i\u015flemlerini ger\u00e7ekle\u015ftirecek.<\/p>\n \u00d6rne\u011fimiz i\u00e7in a\u015fa\u011f\u0131daki endpoint’leri tan\u0131mlayal\u0131m ve bunlar\u0131n hangi HTTP metotlar\u0131 ile e\u015fle\u015fece\u011fini belirleyelim:<\/p>\n Bu yap\u0131, RESTful prensiplere uygun olarak kaynak odakl\u0131 ve sezgisel bir yakla\u015f\u0131m sunar. Veri format\u0131 olarak genellikle JSON (JavaScript Object Notation) kullan\u0131l\u0131r, zira hem hafif hem de okunmas\u0131 kolayd\u0131r.<\/p>\n Bir\u00e7ok programlama dilinde (Python, Java, C#, Go vb.) REST API geli\u015ftirmek m\u00fcmk\u00fcnd\u00fcr. Biz burada pop\u00fcler bir se\u00e7enek olan Node.js ve Express.js framework’\u00fcn\u00fc kullanaca\u011f\u0131z. \u0130lk olarak, projemizi ba\u015flat\u0131p Express’i kural\u0131m:<\/p>\n <\/code><\/p>\n \u015eimdi, <\/code><\/p>\n Bu kod blo\u011fu, temel bir RESTful API'nin nas\u0131l g\u00f6r\u00fcnebilece\u011fini g\u00f6steriyor. Bir \u00fcr\u00fcn listesi tutuyor, gelen HTTP isteklerini i\u015fliyor ve uygun JSON yan\u0131tlar\u0131 ile HTTP durum kodlar\u0131n\u0131 d\u00f6nd\u00fcr\u00fcyor. Ger\u00e7ek bir uygulamada, bu \u00fcr\u00fcn verileri bir veritaban\u0131nda (MongoDB, PostgreSQL vb.) saklanacakt\u0131r.<\/p>\n \u015eimdi, bu API'ye taray\u0131c\u0131 \u00fczerinden veya bir mobil uygulamadan nas\u0131l istek g\u00f6nderebilece\u011fimize dair bir \u00f6rnek g\u00f6relim. Modern web uygulamalar\u0131 genellikle Fetch API<\/a> veya Axios gibi k\u00fct\u00fcphaneleri kullan\u0131r:<\/p>\n <\/code><\/p>\n API, veriyi sa\u011flar; sunum katman\u0131 ise bu veriyi kullan\u0131c\u0131ya g\u00f6sterir. Mobil uygulamalar ve web siteleri genellikle ayn\u0131 REST API'yi t\u00fcketir. Web taraf\u0131nda responsive tasar\u0131m i\u00e7in CSS media query'ler kullan\u0131l\u0131rken, API'nin kendisi mobil platformdan ba\u011f\u0131ms\u0131z \u00e7al\u0131\u015f\u0131r. A\u015fa\u011f\u0131daki basit CSS \u00f6rne\u011fi, web uygulamas\u0131n\u0131n mobil uyumlu bir \u015fekilde API'den gelen veriyi nas\u0131l g\u00f6sterebilece\u011fini betimler:<\/p>\nBir RESTful API Nas\u0131l Tasarlan\u0131r? Temel Prensipler ve En \u0130yi Uygulamalar<\/h2>\n
Kaynaklar\u0131n\u0131z\u0131 Anla\u015f\u0131l\u0131r URI’lerle Nas\u0131l Tan\u0131mlars\u0131n\u0131z?<\/h3>\n
\n
\/api\/urunler<\/code>: T\u00fcm \u00fcr\u00fcnleri listeler.<\/li>\n\/api\/urunler\/123<\/code>: ID’si 123 olan \u00fcr\u00fcn\u00fc getirir.<\/li>\n\/api\/kullanicilar\/456\/siparisler<\/code>: ID’si 456 olan kullan\u0131c\u0131n\u0131n t\u00fcm sipari\u015flerini getirir.<\/li>\n<\/ul>\nHTTP Metotlar\u0131n\u0131 Do\u011fru Kullanarak CRUD \u0130\u015flemlerini Nas\u0131l Ger\u00e7ekle\u015ftirirsiniz?<\/h3>\n
\n
GET \/api\/urunler<\/code> veya GET \/api\/urunler\/123<\/code>.<\/li>\nPOST \/api\/urunler<\/code> (yeni bir \u00fcr\u00fcn olu\u015fturur).<\/li>\nPUT \/api\/urunler\/123<\/code> (ID’si 123 olan \u00fcr\u00fcn\u00fc tamamen g\u00fcnceller).<\/li>\nPATCH \/api\/urunler\/123<\/code> (\u00fcr\u00fcn\u00fcn sadece fiyat\u0131n\u0131 g\u00fcnceller).<\/li>\nDELETE \/api\/urunler\/123<\/code> (ID’si 123 olan \u00fcr\u00fcn\u00fc siler).<\/li>\n<\/ul>\nAPI \u0130steklerine Nas\u0131l Anlaml\u0131 Yan\u0131t Kodlar\u0131 Verirsiniz?<\/h3>\n
\n
\n
200 OK<\/code>: \u0130stek ba\u015far\u0131yla tamamland\u0131. (GET, PUT, PATCH, DELETE)<\/li>\n201 Created<\/code>: Yeni bir kaynak ba\u015far\u0131yla olu\u015fturuldu. (POST)<\/li>\n204 No Content<\/code>: \u0130stek ba\u015far\u0131yla i\u015flendi, ancak yan\u0131t g\u00f6vdesinde i\u00e7erik yok. (DELETE)<\/li>\n<\/ul>\n<\/li>\n\n
400 Bad Request<\/code>: \u0130stek ge\u00e7ersiz veya hatal\u0131 parametreler i\u00e7eriyor.<\/li>\n401 Unauthorized<\/code>: Kimlik do\u011frulama ba\u015far\u0131s\u0131z oldu veya gerekli.<\/li>\n403 Forbidden<\/code>: Yetkilendirme yetersizli\u011fi (izin yok).<\/li>\n404 Not Found<\/code>: \u0130stenen kaynak bulunamad\u0131.<\/li>\n405 Method Not Allowed<\/code>: Belirtilen HTTP metodu kayna\u011fa uygulanamaz.<\/li>\n<\/ul>\n<\/li>\n\n
500 Internal Server Error<\/code>: Sunucu taraf\u0131nda beklenmeyen bir hata olu\u015ftu.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\nG\u00fcvenli API Tasar\u0131m\u0131n\u0131n P\u00fcf Noktalar\u0131 Nelerdir?<\/h3>\n
\n
Ad\u0131m Ad\u0131m REST API Geli\u015ftirme: Pratik Bir Uygulama<\/h2>\n
Basit Bir \u00dcr\u00fcn Katalo\u011fu API’si i\u00e7in Endpoint’ler Nas\u0131l Tan\u0131mlan\u0131r?<\/h3>\n
\n
GET \/api\/products<\/code><\/li>\nGET \/api\/products\/{id}<\/code><\/li>\nPOST \/api\/products<\/code><\/li>\nPUT \/api\/products\/{id}<\/code><\/li>\nDELETE \/api\/products\/{id}<\/code><\/li>\n<\/ul>\nNode.js ve Express ile Temel Bir API Servisi Kurulumu<\/h3>\n
\nnpm init -y\nnpm install express\n<\/pre>\napp.js<\/code> adl\u0131 bir dosya olu\u015ftural\u0131m ve temel bir sunucu ile endpoint'leri tan\u0131mlayal\u0131m:<\/p>\n\nconst express = require('express');\nconst app = express();\nconst PORT = 3000;\n\n\/\/ JSON body parser'\u0131 etkinle\u015ftir\napp.use(express.json());\n\n\/\/ Ge\u00e7ici bir \u00fcr\u00fcn veritaban\u0131 (ger\u00e7ek uygulamada bir DB kullan\u0131lmal\u0131)\nlet products = [\n { id: '1', name: 'Ak\u0131ll\u0131 Telefon', price: 7500, category: 'Elektronik' },\n { id: '2', name: 'Kablosuz Kulakl\u0131k', price: 1200, category: 'Elektronik' },\n { id: '3', name: 'Diz\u00fcst\u00fc Bilgisayar', price: 18000, category: 'Bilgisayar' }\n];\n\n\/\/ 1. T\u00fcm \u00fcr\u00fcnleri getir (GET \/api\/products)\napp.get('\/api\/products', (req, res) => {\n res.json(products);\n});\n\n\/\/ 2. Belirli bir \u00fcr\u00fcn\u00fc getir (GET \/api\/products\/{id})\napp.get('\/api\/products\/:id', (req, res) => {\n const { id } = req.params;\n const product = products.find(p => p.id === id);\n if (product) {\n res.json(product);\n } else {\n res.status(404).json({ message: '\u00dcr\u00fcn bulunamad\u0131.' });\n }\n});\n\n\/\/ 3. Yeni bir \u00fcr\u00fcn olu\u015ftur (POST \/api\/products)\napp.post('\/api\/products', (req, res) => {\n const newProduct = {\n id: (products.length + 1).toString(), \/\/ Basit ID atama\n name: req.body.name,\n price: req.body.price,\n category: req.body.category\n };\n if (!newProduct.name || !newProduct.price || !newProduct.category) {\n return res.status(400).json({ message: 'L\u00fctfen t\u00fcm alanlar\u0131 doldurun.' });\n }\n products.push(newProduct);\n res.status(201).json(newProduct);\n});\n\n\/\/ 4. Belirli bir \u00fcr\u00fcn\u00fc g\u00fcncelle (PUT \/api\/products\/{id})\napp.put('\/api\/products\/:id', (req, res) => {\n const { id } = req.params;\n const { name, price, category } = req.body;\n let productFound = false;\n products = products.map(p => {\n if (p.id === id) {\n productFound = true;\n return { ...p, name, price, category }; \/\/ T\u00fcm alanlar\u0131 g\u00fcnceller\n }\n return p;\n });\n if (productFound) {\n const updatedProduct = products.find(p => p.id === id);\n res.json(updatedProduct);\n } else {\n res.status(404).json({ message: '\u00dcr\u00fcn bulunamad\u0131.' });\n }\n});\n\n\/\/ 5. Belirli bir \u00fcr\u00fcn\u00fc sil (DELETE \/api\/products\/{id})\napp.delete('\/api\/products\/:id', (req, res) => {\n const { id } = req.params;\n const initialLength = products.length;\n products = products.filter(p => p.id !== id);\n if (products.length < initialLength) {\n res.status(204).send(); \/\/ Ba\u015far\u0131l\u0131, i\u00e7erik yok\n } else {\n res.status(404).json({ message: '\u00dcr\u00fcn bulunamad\u0131.' });\n }\n});\n\napp.listen(PORT, () => {\n console.log(Sunucu http:\/\/localhost:${PORT} adresinde \u00e7al\u0131\u015f\u0131yor.<\/code>);\n});\n<\/pre>\n\u0130stemci Taraf\u0131ndan API'ye Nas\u0131l \u0130stek G\u00f6nderilir?<\/h3>\n
\n\/\/ T\u00fcm \u00fcr\u00fcnleri getir\nfetch('http:\/\/localhost:3000\/api\/products')\n .then(response => response.json())\n .then(data => console.log('T\u00fcm \u00dcr\u00fcnler:', data))\n .catch(error => console.error('Hata:', error));\n\n\/\/ ID'si 1 olan \u00fcr\u00fcn\u00fc getir\nfetch('http:\/\/localhost:3000\/api\/products\/1')\n .then(response => response.json())\n .then(data => console.log('\u00dcr\u00fcn 1:', data))\n .catch(error => console.error('Hata:', error));\n\n\/\/ Yeni \u00fcr\u00fcn olu\u015ftur\nfetch('http:\/\/localhost:3000\/api\/products', {\n method: 'POST',\n headers: {\n 'Content-Type': 'application\/json'\n },\n body: JSON.stringify({\n name: 'Ak\u0131ll\u0131 Saat',\n price: 3500,\n category: 'Giyilebilir Teknoloji'\n })\n})\n.then(response => response.json())\n.then(data => console.log('Yeni \u00dcr\u00fcn:', data))\n.catch(error => console.error('Hata:', error));\n<\/pre>\nMobil Uyumlu Tasar\u0131m ve API \u0130li\u015fkisi<\/h3>\n
\n