Yayına alma ve Blok 4 projesi: takım API'si

Blok 4 boyunca sunucu yazdın: önce node:http ile, sonra Express ile. Veriyi dosyada tuttun, ayarları ortam değişkenlerine taşıdın, dış API'lere bağlandın, kimlik doğrulamayı öğrendin. Ama hepsi senin bilgisayarında çalıştı; bilgisayarın kapanınca API'n de kapandı.

Bu derste hepsini tek bir projede topluyorsun: takımları ve şampiyon havuzunu yöneten bir API yazacak, her ucunu deneyecek, belgesini yazacak ve yayına alacaksın: Ders 25'te statik bir siteyle yaptığını bu kez çalışan bir sunucuyla yapacaksın. Yolda barındırma türlerini, uyuyan sunucuları, loglardan hata bulmayı ve bir alan adını sunucuya bağlayan DNS kayıtlarını öğreneceksin.

#Barındırma: API'n nerede yaşayacak?

Takım API'n şu an localhost:3000'de. Ders 18'den hatırla: localhost "bu bilgisayar" demek. Arkadaşın kendi bilgisayarında aynı adresi yazarsa kendi bilgisayarına bakar, senin API'ni bulamaz.

Bilgisayarını internete açmak da çözüm değil. Bilgisayar kapanınca, uyku moduna geçince ya da modem yeniden başlayınca API de kaybolur. Evdeki internetin IP adresi çoğu zaman sabit değildir ve modemler dışarıdan gelen bağlantıları varsayılan olarak geri çevirir. API'nin, internete hep bağlı ve hiç kapanmayan bir bilgisayarda çalışması gerekiyor.

GitHub Pages da bir barındırıcıydı, ama yalnız statik siteler için: dosyaları olduğu gibi gönderir, programını çalıştırmaz. Takım API'si ise her isteğin yanıtını o anda hesaplayan bir Node programı. Node programı çalıştıran barındırıcılar iki aileye ayrılır.

#İki aile: sürekli çalışan ve sunucusuz

• Sürekli çalışan sunucu. Barındırıcı programını bir kez başlatır. Program, senin bilgisayarındaki npm start gibi açık kalır ve gelen istekleri karşılar. Değişkenler istekler arasında yaşar. Render, Railway, Fly.io ve kiralık sanal sunucular (VPS) bu ailedendir.
• Sunucusuz. Programı sen başlatmazsın. Bir istek gelince barındırıcı kodunun bir kopyasını çalıştırır, iş bitince kopyayı bir süre bekletir, sonra kapatır. Trafik artınca aynı anda birçok kopya açar. Vercel Functions, Netlify Functions, Cloudflare Workers ve AWS Lambda bu ailedendir.

#Ücretsiz seçenekler ve sınırları

Barındırıcıların ücretsiz planları sık değişir. Aşağıdaki bilgiler bu ders yazılırken, 12 Ekim 2026'da, iki barındırıcının resmî belgelerinden alındı. Karar vermeden önce güncel sayfalara bak.

Tablodaki çalışma alanı (workspace), Render'da servislerinin toplandığı hesap bölümü. Render'a kaydolunca ücretsiz Hobby çalışma alanıyla başlarsın; Pro gibi ücretli çalışma alanları daha uzun log süresi gibi ek özellikler verir.

Başka seçenekler de var. Örneğin Railway, 30 günlük bir deneme ve tek seferlik 5 dolarlık kredi veriyor; deneme bitince ayda 1 dolarlık krediyle ücretsiz plana geçiliyor.

750 saati hesapla: 31 gün çarpı 24 saat 744 saat eder. Yani tek bir servis ay boyunca hiç uyumasa bile saat yeter. İki servisi sürekli açık tutarsan saatler biter ve Render bütün ücretsiz servislerini ayın sonuna kadar askıya alır.

Bu derste Render'ı kullanacağız. Sebebi basit: Express API'n orada hiçbir değişiklik olmadan, bilgisayarındaki gibi npm start ile çalışıyor.

#Uyuma ve soğuk başlangıç

Render'ın ücretsiz servisi 15 dakika boyunca hiç istek almazsa uyur: barındırıcı programını durdurur. Sonraki istek gelince programı yeniden başlatır. Bu yaklaşık bir dakika sürer ve o ilk istek bütün bu süreyi bekler.

Render, uyanma sırasında tarayıcıyla gelenlere bir "yükleniyor" sayfası gösterir. curl.exe ya da senin yazdığın bir program ise yanıtı bekler. Bekleyen taraf kısa bir zaman aşımı koyduysa (Ders 30'daki AbortSignal.timeout gibi) ilk istek hata alabilir. Ücretsiz bir API kullanan bir web sayfası yazıyorsan ilk istekte biraz sabırlı ol ya da kullanıcıya "sunucu uyanıyor" de.

Sunucusuz barındırıcılarda da soğuk başlangıç vardır, ama genelde daha kısadır: hiç açık kopya yoksa yenisi açılır, bu bir saniyenin altında da sürebilir, birkaç saniye de. Vercel'in belgesine göre iki hafta hiç çağrılmayan bir fonksiyon arşivlenir ve ilk çağrısı en az bir saniye daha uzun sürer.

#Dosyaya yazdığın veri neden kaybolur?

Takım API'si verisini veri.json dosyasında tutacak. Ders 29'da dosyayı kalıcılık için kullanmıştın: bilgisayarında bu dosya sen silene kadar durur. Barındırıcıda ise durum farklı.

• Render: Belgesi açıkça söylüyor: ücretsiz servisin diski geçicidir; yüklenen dosyalar gibi yerel değişiklikler yeni sürümde, yeniden başlatmada ve uykuda kaybolur. Render ücretsiz servisi istediği an yeniden başlatabilir de. Ücretsiz serviste kalıcı disk de kullanamazsın. Yani yayındaki API'ne bir takım eklersin, 15 dakika kimse uğramaz, servis uyur; uyanınca veri.json GitHub'daki hâline dönmüştür ve takımın yoktur.
• Vercel: Kodun durduğu klasör salt okunurdur; veri.json'a yazmaya kalkan kod hata alır. Yalnız /tmp klasörüne yazılabilir. Ama her kopyanın kendi /tmp'si vardır ve kopya kapanınca o da gider; A kopyasına yazdığını, B kopyasına düşen sonraki istek göremez.

#Proje planı: takım API'si

API'n iki kaynağı yönetecek (Ders 26'daki REST mantığıyla): takımlar ve şampiyon havuzu. Her takımın adı, oyuncuları ve en çok beş şampiyonu var; şampiyonlar havuzdan seçilir.

Bunlara ek olarak her istek terminale bir satır yazacak, bozuk JSON 400, bilinmeyen adres 404, beklenmeyen hata 500 alacak ve tek bir ayarla bütün yazma işlemleri kapatılabilecek. Görevlerde de sağlık ucu, arama, sayfalama ve istek kimliği ekleyeceksin.

Proje bittiğinde klasörün şöyle görünecek:

takim-api/├── .env              PORT ve öteki ayarlar (Git'e girmez)├── .gitignore├── package.json├── package-lock.json├── veri.json         takımlar ve şampiyon havuzu├── dogrula.js        gelen veriyi denetleyen fonksiyonlar├── sunucu.js         Express uygulaması└── README.md         API belgesi

#Kurulum

Terminalde cd C:\kod ile kod klasörüne geç, mkdir takim-api ile yeni klasörü oluştur ve cd takim-api ile içine gir. Sonra package.json'ı oluştur:

PS C:\kod\takim-api> npm init -yWrote to C:\kod\takim-api\package.json: {  "name": "takim-api",  "version": "1.0.0",  "description": "",  "main": "index.js",  "scripts": {    "test": "echo \"Error: no test specified\" && exit 1"  },  "keywords": [],  "author": "",  "license": "ISC",  "type": "commonjs"}

Klasörü VS Code'da aç ve package.json'da üç şeyi değiştir: "type"'ı "module" yap, scripts'i aşağıdaki iki betikle değiştir ve en alta engines kısmını ekle. Sonra Express'i kur:

PS C:\kod\takim-api> npm install express added 65 packages, and audited 66 packages in 2s 28 packages are looking for funding  run `npm fund` for details found 0 vulnerabilities

Kurulumdan sonra dosya şöyle olmalı:

1{2  "name": "takim-api",3  "version": "1.0.0",4  "description": "",5  "main": "index.js",6  "scripts": {7    "start": "node sunucu.js",8    "dev": "node --watch --env-file=.env sunucu.js"9  },10  "keywords": [],11  "author": "",12  "license": "ISC",13  "type": "module",14  "engines": {15    "node": "24.x"16  },17  "dependencies": {18    "express": "^5.3.0"19  }20}

• start yayında kullanılacak: yalnız node sunucu.js. Barındırıcıda .env dosyası olmayacak, ayarları barındırıcı verecek. Bu yüzden --env-file yalnız kendi bilgisayarında çalışan dev betiğinde.
• engines, projenin hangi Node sürümüyle çalıştığını söyler. 24.x "24 ile başlayan herhangi bir sürüm" demek (Ders 14'teki anlamsal sürümleme). Render bu satıra bakıp sürümü seçer; belgesi aralığa bir üst sınır koymanı öneriyor, 24.x de 25'i dışarıda bırakıyor.
• Bu ders yazılırken Express'in son sürümü 5.3.0'dı. Sende daha yeni bir 5.x çıkabilir; ^ işareti 5'ten başlayan yeni sürümlere izin verir.

#Başlangıç verisi: veri.json

Proje klasöründe veri.json adında bir dosya aç ve şunu yaz. Dersin çıktıları bu veriyle alındı; kendi takımlarını daha sonra ekleyebilirsin.

1{2  "sonId": 6,3  "sampiyonlar": [4    "Ahri", "Annie", "Brand", "Garen", "Jinx", "Lee Sin", "Lux",5    "Morgana", "Sona", "Teemo", "Thresh", "Vi", "Yasuo", "Zed"6  ],7  "takimlar": [8    {9      "id": 1,10      "ad": "Gece Kurtları",11      "olusturulma": "2026-09-01T18:30:00.000Z",12      "oyuncular": [13        { "kullaniciAdi": "deniz", "rol": "orta" },14        { "kullaniciAdi": "ece", "rol": "destek" }15      ],16      "sampiyonlar": ["Ahri", "Lux", "Garen"]17    },18    {19      "id": 2,20      "ad": "Mavi Ejderler",21      "olusturulma": "2026-09-02T09:15:00.000Z",22      "oyuncular": [23        { "kullaniciAdi": "mert", "rol": "alt" },24        { "kullaniciAdi": "selin", "rol": "orman" }25      ],26      "sampiyonlar": ["Jinx", "Thresh", "Lux"]27    },28    {29      "id": 3,30      "ad": "Baron Avcıları",31      "olusturulma": "2026-09-03T20:00:00.000Z",32      "oyuncular": [33        { "kullaniciAdi": "kaan", "rol": "orman" },34        { "kullaniciAdi": "zeynep", "rol": "üst" }35      ],36      "sampiyonlar": ["Yasuo", "Lee Sin"]37    },38    {39      "id": 4,40      "ad": "Kuzey Rüzgarı",41      "olusturulma": "2026-09-05T11:45:00.000Z",42      "oyuncular": [43        { "kullaniciAdi": "arda", "rol": "üst" },44        { "kullaniciAdi": "ipek", "rol": "orta" }45      ],46      "sampiyonlar": ["Annie", "Teemo"]47    },48    {49      "id": 5,50      "ad": "Ateş Kuşları",51      "olusturulma": "2026-09-09T19:40:00.000Z",52      "oyuncular": [53        { "kullaniciAdi": "cem", "rol": "orta" },54        { "kullaniciAdi": "elif", "rol": "destek" }55      ],56      "sampiyonlar": ["Annie", "Brand"]57    },58    {59      "id": 6,60      "ad": "Kurt Sürüsü",61      "olusturulma": "2026-09-12T21:10:00.000Z",62      "oyuncular": [63        { "kullaniciAdi": "ozan", "rol": "üst" },64        { "kullaniciAdi": "irem", "rol": "orman" }65      ],66      "sampiyonlar": ["Teemo", "Yasuo"]67    }68  ]69}

• sonId: en son verilen takım numarası. Yeni takım sonId + 1 alır. Bir takım silinse bile numarası yeniden kullanılmaz; /api/takimlar/4 adresi hep aynı takımı göstermeli.
• sampiyonlar: havuz. Takımlar şampiyonlarını yalnız buradan seçebilir.
• olusturulma: takımın eklendiği an, Ders 12'deki JSON'da tarih tipi olmadığı için metin olarak. Biçimi birazdan göreceksin.

#Ayarlar: .env ve .gitignore

API'nin iki ayarı .env'de duracak:

1PORT=30002VERI_DOSYASI=veri.json

1node_modules2.env

PORT sunucunun dinleyeceği kapı, VERI_DOSYASI verinin tutulacağı dosya. İkisi de gizli değil; yine de .env'yi Git'e koymuyoruz, çünkü ileride içine gizli bilgiler de girecek ve her bilgisayarın .env'si farklıdır. Kodda bir de üçüncü ayar olacak: SALT_OKUNUR. Onu .env'ye yazmıyoruz; yayındaki API'de, barındırıcının panelinden açıp kapatacağız.

#Gelen veriyi denetlemek: dogrula.js

API'ne internetten herkes istek atabilecek. Bir kısmı yanlışlıkla, bir kısmı bilerek bozuk veri gönderecek: tek harflik bir ad, sayı yerine metin, havuzda olmayan bir şampiyon. Ders 13'teki kural burada da geçerli: dışarıdan gelen hiçbir veriye güvenme, önce denetle.

Denetimleri sunucu.js'ten ayrı bir dosyaya koyuyoruz. Bunun iki faydası var: route'lar kısa kalır, denetim fonksiyonları da sunucuyu açmadan tek başına denenebilir. Proje klasöründe dogrula.js adında bir dosya aç:

1const ROLLER = ["üst", "orman", "orta", "alt", "destek"]2 3export function adHatasi(ad) {4    if (typeof ad !== "string") {5        return "ad bir metin olmalı"6    }7    const uzunluk = ad.trim().length8    if (uzunluk < 2 || uzunluk > 40) {9        return "ad 2 ile 40 karakter arasında olmalı"10    }11    return null12}13 14export function takimHatasi(govde, havuz) {15    const adSorunu = adHatasi(govde?.ad)16    if (adSorunu) {17        return adSorunu18    }19    const oyuncular = govde.oyuncular ?? []20    if (!Array.isArray(oyuncular) || oyuncular.length > 5) {21        return "oyuncular en çok 5 elemanlı bir dizi olmalı"22    }23    for (const oyuncu of oyuncular) {24        if (typeof oyuncu?.kullaniciAdi !== "string" || oyuncu.kullaniciAdi.trim() === "") {25            return "her oyuncunun kullaniciAdi alanı dolu olmalı"26        }27        if (!ROLLER.includes(oyuncu.rol)) {28            return "rol şunlardan biri olmalı: " + ROLLER.join(", ")29        }30    }31    const sampiyonlar = govde.sampiyonlar ?? []32    if (!Array.isArray(sampiyonlar) || sampiyonlar.length > 5) {33        return "sampiyonlar en çok 5 elemanlı bir dizi olmalı"34    }35    const gorulen = []36    for (const ad of sampiyonlar) {37        if (!havuz.includes(ad)) {38            return `${ad} şampiyon havuzunda yok`39        }40        if (gorulen.includes(ad)) {41            return `${ad} listede iki kez geçiyor`42        }43        gorulen.push(ad)44    }45    return null46}47 48export function sampiyonHatasi(ad, havuz) {49    if (typeof ad !== "string") {50        return "ad bir metin olmalı"51    }52    const temiz = ad.trim()53    if (temiz.length < 2 || temiz.length > 20) {54        return "şampiyon adı 2 ile 20 karakter arasında olmalı"55    }56    if (havuz.some((mevcut) => mevcut.toLowerCase() === temiz.toLowerCase())) {57        return `${temiz} zaten havuzda`58    }59    return null60}

Üç fonksiyonun da sözü aynı: sorun varsa açıklamasını, yoksa null döndür. Böylece route'ta tek bir if yeter.

• adHatasi, adın metin olup olmadığına ve baştaki, sondaki boşluklar atıldıktan sonra 2 ile 40 karakter arasında olup olmadığına bakar. " G " görünüşte uzun, ama içinde tek harf var.
• takimHatasi(govde, havuz) bütün gövdeyi denetler. govde?.ad'deki ?. (Ders 12) önemli: Express 5'te gövdesiz bir isteğin req.body'si undefined olur. govde.ad yazsaydık API, gövdesiz bir POST'ta TypeError ile çökerdi.
• Array.isArray(deger) "bu bir dizi mi?" sorusunun cevabını verir. typeof burada işe yaramaz, çünkü dizilere de "object" der.
• Oyuncu ya da şampiyon gönderilmezse ?? [] boş listeyi varsayar; ikisi de isteğe bağlı.
• Tekrarı gorulen dizisiyle yakalıyoruz: her şampiyon önce bu diziye bakılarak denetlenir, sonra eklenir.
• sampiyonHatasi aynı şampiyonun ikinci kez eklenmesini, büyük-küçük harfe bakmadan engeller: " lux " ile "Lux" aynı şampiyon. Şampiyon adları İngilizce olduğu için düz toLowerCase yeterli (Ders 9'daki kural).

Fonksiyonları sunucuya bağlamadan önce sınırlarda dene. Aynı klasörde dogrula-deneme.js adında geçici bir dosya aç. "A".repeat(40) "A harfini 40 kez yan yana yaz" demek; adı tam sınırda denemenin kısa yolu:

1import { adHatasi, takimHatasi, sampiyonHatasi } from "./dogrula.js"2 3const havuz = ["Ahri", "Lux", "Zed"]4 5console.log(adHatasi("G"))6console.log(adHatasi("Gö"))7console.log(adHatasi("    G    "))8console.log(adHatasi("A".repeat(40)))9console.log(adHatasi("A".repeat(41)))10console.log(adHatasi(123))11console.log(takimHatasi(undefined, havuz))12console.log(takimHatasi({ ad: "Gece Kurtları", sampiyonlar: ["Ahri", "Lux"] }, havuz))13console.log(takimHatasi({ ad: "Gece Kurtları", sampiyonlar: ["Ahri", "Ahri"] }, havuz))14console.log(takimHatasi({ ad: "Gece Kurtları", oyuncular: [{ kullaniciAdi: "deniz", rol: "jungle" }] }, havuz))15console.log(sampiyonHatasi(" lux ", havuz))

PS C:\kod\takim-api> node dogrula-deneme.jsad 2 ile 40 karakter arasında olmalınullad 2 ile 40 karakter arasında olmalınullad 2 ile 40 karakter arasında olmalıad bir metin olmalıad bir metin olmalınullAhri listede iki kez geçiyorrol şunlardan biri olmalı: üst, orman, orta, alt, desteklux zaten havuzda

2 karakter ve 40 karakter geçti, 1 ve 41 geçmedi: sınırlar doğru yerde. Gövdesiz istek (undefined) çökmek yerine anlaşılır bir mesaj aldı. Denedikten sonra dogrula-deneme.js'i sil; projenin parçası değil.

#sunucu.js: parça parça

Şimdi asıl dosya. sunucu.js'i yukarıdan aşağı, parça parça yazacağız; her parçanın başındaki satır numarası dosyadaki yerini gösteriyor. Parçaları sırayla alt alta yazınca dosyanın tamamı ortaya çıkar.

#Ayarlar ve veri dosyası

1import express from "express"2import { readFile, writeFile } from "node:fs/promises"3import { resolve } from "node:path"4import { adHatasi, takimHatasi, sampiyonHatasi } from "./dogrula.js"5 6const app = express()7const port = process.env.PORT ?? 30008const veriDosyasi = resolve(import.meta.dirname, process.env.VERI_DOSYASI ?? "veri.json")9const saltOkunur = process.env.SALT_OKUNUR === "evet"10 11async function veriyiOku() {12    const metin = await readFile(veriDosyasi, "utf8")13    return JSON.parse(metin)14}15 16async function veriyiYaz(veri) {17    await writeFile(veriDosyasi, JSON.stringify(veri, null, 2))18}

• Bütün ayarlar en üstte, program başlarken bir kez okunuyor. Yayında bir ayarı değiştirirsen programın yeniden başlaması gerekir; barındırıcı bunu kendisi yapacak.
• Ortam değişkenleri her zaman metindir. SALT_OKUNUR için === "evet" diye soruyoruz; değişken hiç yoksa sonuç false olur.
• import.meta.dirname bu dosyanın bulunduğu klasör: C:\kod\takim-api (Ders 29). Orada path.join ile birleştirmiştin; burada node:path'in resolve fonksiyonunu kullanıyoruz, çünkü bir farkı var: ad zaten tam bir yolsa (D:\yedek\veri.json gibi) klasörü atıp onu olduğu gibi kullanır. Böylece VERI_DOSYASI ayarına hem veri.json hem tam bir yol yazılabilir.
• veriyiOku her istekte dosyayı baştan okur, veriyiYaz bütün veriyi geri yazar. JSON.stringify(veri, null, 2) dosyayı 2 boşluk girintiyle, okunur biçimde yazar (Ders 12).

Neden düz "veri.json" değil de tam yol? Ders 29'dan hatırla: göreli bir yol, dosyanın değil, programın çalışma klasörünün içinde aranır. Kendi bilgisayarında hep proje klasöründen başlattığın için fark etmezsin; başka bir klasörden başlatan ya da projeyi bir alt klasörde tutan bir barındırıcı ise dosyayı bulamaz:

PS C:\kod> node takim-api\sunucu.jsTakım API'si çalışıyor: http://localhost:3000Veri dosyası: veri.jsonError: ENOENT: no such file or directory, open 'C:\kod\veri.json'    at async open (node:internal/fs/promises:1345:25)    at async readFile (node:internal/fs/promises:1996:14)    at async veriyiOku (file:///C:/kod/takim-api/sunucu.js:12:19)    at async file:///C:/kod/takim-api/sunucu.js:39:18 {  errno: -4058,  code: 'ENOENT',  syscall: 'open',  path: 'C:\\kod\\veri.json'}GET /api/takimlar 500 5 ms

#Kayıt ara katmanı

Yayındaki API'nin başında oturmayacaksın. Kim, ne zaman, hangi adrese istek attı, ne cevap aldı, ne kadar sürdü: bunları sonradan okuyabilmek için her isteğin bir satırlık kaydını tutman gerekir.

Render gelen istekleri ancak ücretli Pro ve üstü çalışma alanlarında kendiliğinden loglar; ücretsiz Hobby çalışma alanında bunu kendin yapman gerekir. İşi, Ders 28'de yazdığın kayıt tutucunun aynısı görecek. sunucu.js'e devam et:

20app.use((req, res, next) => {21    const baslangic = Date.now()22    res.on("finish", () => {23        const sure = Date.now() - baslangic24        console.log(`${req.method} ${req.originalUrl} ${res.statusCode} ${sure} ms`)25    })26    next()27})

Ders 28'den hatırla:

• Date.now() o anın milisaniye cinsinden değeri (Ders 23). İstek gelince bir kez okuyoruz, yanıt bitince bir kez daha; fark, isteğin ne kadar sürdüğü.
• res.on("finish", fonksiyon): "yanıt gönderilip bitince bu fonksiyonu çalıştır." Durum kodunu ancak yanıt bitince bilebildiğimiz için satırı orada yazıyoruz.
• next() isteği sıradaki ara katmana geçirir. Unutursan ısınmadaki ikinci sorunun belirtisi çıkar: hiçbir istek yanıt almaz.

Tek yenilik req.url yerine req.originalUrl: isteğin geldiği tam adres, sorgu kısmı (?ara=kurt gibi) dahil. Bu projede ikisi aynı şeyi yazar. Express bazı durumlarda req.url'yi yolda değiştirir, originalUrl ise hep ilk hâli tutar; loga yazılacak adres için daha güvenli seçim bu.

Bu ara katman en üstte, bütün route'lardan önce durmalı. Express ara katmanları yazıldıkları sırayla çalıştırır; route'lardan sonraya koyarsan, yanıtı zaten gönderilmiş istekler ona hiç uğramaz.

#Salt okunur anahtarı ve JSON gövdesi

29app.use((req, res, next) => {30    if (saltOkunur && req.method !== "GET") {31        return res.status(503).json({ hata: "API şu an salt okunur" })32    }33    next()34})35 36app.use(express.json())

Bu, Ders 28'deki bakım modu görevinin aynısı. SALT_OKUNUR=evet ise GET dışındaki bütün istekler, route'lara hiç ulaşmadan 503 Service Unavailable ("hizmet şu an kullanılamıyor") alır.

Tek fark anahtarın yeri: Ders 28'de kodda bir const'tu, burada bir ortam değişkeni. Böylece bakım yaparken ya da herkese açık bir deneme API'sini bozulmaktan korumak isterken, yayındaki API'de kodu değiştirmeden yazmayı kapatırsın. express.json() bu kapıdan sonra geliyor; reddedeceğimiz bir isteğin gövdesini okumaya gerek yok.

Bir isteğin sunucu.js içindeki bütün yolu şöyle:

#Takım uç noktaları

Beş route da aynı düzende: dosyayı oku, bul ya da denetle, değiştir, dosyaya yaz, yanıtla. Ders 28'deki CRUD'un aynısı; tek fark verinin dizide değil, dosyada durması.

38app.get("/api/takimlar", async (req, res) => {39    const veri = await veriyiOku()40    res.json(veri.takimlar)41})42 43app.get("/api/takimlar/:id", async (req, res) => {44    const veri = await veriyiOku()45    const takim = veri.takimlar.find((t) => t.id === Number(req.params.id))46    if (!takim) {47        return res.status(404).json({ hata: "Takım bulunamadı" })48    }49    res.json(takim)50})51 52app.post("/api/takimlar", async (req, res) => {53    const veri = await veriyiOku()54    const hata = takimHatasi(req.body, veri.sampiyonlar)55    if (hata) {56        return res.status(400).json({ hata })57    }58    const oyuncular = req.body.oyuncular ?? []59    veri.sonId = veri.sonId + 160    const takim = {61        id: veri.sonId,62        ad: req.body.ad.trim(),63        olusturulma: new Date().toISOString(),64        oyuncular: oyuncular.map((o) => ({ kullaniciAdi: o.kullaniciAdi.trim(), rol: o.rol })),65        sampiyonlar: req.body.sampiyonlar ?? []66    }67    veri.takimlar.push(takim)68    await veriyiYaz(veri)69    res.status(201).json(takim)70})

• req.params.id her zaman metindir ("3"); Number ile sayıya çevirip id ile karşılaştırıyoruz. "abc" gibi bir değer NaN olur, hiçbir takımla eşleşmez ve 404 döner.
• return res.status(...): hata yanıtından sonra fonksiyonu bitiriyoruz ki ikinci bir yanıt yazılmasın (Ders 27'deki ERR_HTTP_HEADERS_SENT).
• { hata }, { hata: hata }'nın kısa yazımı: alanın adı, değerini tutan kutunun adıyla aynıysa bir kez yazman yeter. Ders 12'deki const { hp } = ahri parçalamasının tersi gibi düşün: orada alan kutuya açılıyordu, burada kutu aynı adlı alana giriyor.
• new Date().toISOString() şu anı dünya saatiyle (UTC) ve her dilde aynı okunan bir biçimde yazar: 2026-10-11T18:17:42.853Z. Sondaki Z, saatin UTC olduğunu söyler; Türkiye saati bunun 3 saat ilerisidir.
• Oyuncuları olduğu gibi kaydetmiyoruz: map her oyuncudan yalnız kullaniciAdi ve rol alanlarını alıyor. Biri gövdeye "yonetici": true gibi fazladan bir alan koysa bile dosyaya girmez.

72app.patch("/api/takimlar/:id", async (req, res) => {73    const veri = await veriyiOku()74    const takim = veri.takimlar.find((t) => t.id === Number(req.params.id))75    if (!takim) {76        return res.status(404).json({ hata: "Takım bulunamadı" })77    }78    const hata = adHatasi(req.body?.ad)79    if (hata) {80        return res.status(400).json({ hata })81    }82    takim.ad = req.body.ad.trim()83    await veriyiYaz(veri)84    res.json(takim)85})86 87app.delete("/api/takimlar/:id", async (req, res) => {88    const veri = await veriyiOku()89    const id = Number(req.params.id)90    if (!veri.takimlar.some((t) => t.id === id)) {91        return res.status(404).json({ hata: "Takım bulunamadı" })92    }93    veri.takimlar = veri.takimlar.filter((t) => t.id !== id)94    await veriyiYaz(veri)95    res.status(204).end()96})

PATCH takımın yalnız adını değiştirir. takim, veri.takimlar dizisinin içindeki objenin kendisi (Ders 12'deki referans); onun adını değiştirince veri de değişmiş olur, veriyiYaz da bu hâli yazar. DELETE önce some ile "bu numarada bir takım var mı?" diye sorar (Ders 11), sonra Ders 28'deki gibi filter ile o takımı dışarıda bırakan yeni bir dizi kurar ve gövdesiz 204 döner.

#Şampiyon uç noktaları

98app.get("/api/sampiyonlar", async (req, res) => {99    const veri = await veriyiOku()100    res.json(veri.sampiyonlar)101})102 103app.post("/api/sampiyonlar", async (req, res) => {104    const veri = await veriyiOku()105    const hata = sampiyonHatasi(req.body?.ad, veri.sampiyonlar)106    if (hata) {107        return res.status(400).json({ hata })108    }109    const ad = req.body.ad.trim()110    veri.sampiyonlar.push(ad)111    veri.sampiyonlar.sort((a, b) => a.localeCompare(b))112    await veriyiYaz(veri)113    res.status(201).json({ ad })114})

Havuz alfabetik kalsın diye her eklemeden sonra localeCompare ile sıralıyoruz (Ders 11).

Şampiyonun adını değiştirmek daha ilginç. Ad yalnız havuzda değil, onu seçen her takımın içinde de yazılı. Bir yerde değiştirip ötekileri unutursan takımlar havuzda olmayan bir şampiyonu göstermeye başlar. Bu yüzden route bütün takımları tek tek dolaşıyor:

116app.patch("/api/sampiyonlar/:ad", async (req, res) => {117    const veri = await veriyiOku()118    const eskiAd = req.params.ad119    if (!veri.sampiyonlar.includes(eskiAd)) {120        return res.status(404).json({ hata: "Şampiyon bulunamadı" })121    }122    const hata = sampiyonHatasi(req.body?.ad, veri.sampiyonlar)123    if (hata) {124        return res.status(400).json({ hata })125    }126    const yeniAd = req.body.ad.trim()127    const degistir = (ad) => (ad === eskiAd ? yeniAd : ad)128    veri.sampiyonlar = veri.sampiyonlar.map(degistir).sort((a, b) => a.localeCompare(b))129    let takimSayisi = 0130    for (const takim of veri.takimlar) {131        if (takim.sampiyonlar.includes(eskiAd)) {132            takim.sampiyonlar = takim.sampiyonlar.map(degistir)133            takimSayisi = takimSayisi + 1134        }135    }136    await veriyiYaz(veri)137    res.json({ eskiAd, yeniAd, takimSayisi })138})139 140app.delete("/api/sampiyonlar/:ad", async (req, res) => {141    const veri = await veriyiOku()142    const ad = req.params.ad143    if (!veri.sampiyonlar.includes(ad)) {144        return res.status(404).json({ hata: "Şampiyon bulunamadı" })145    }146    const kullananlar = veri.takimlar.filter((t) => t.sampiyonlar.includes(ad))147    if (kullananlar.length > 0) {148        return res.status(400).json({ hata: `${ad} ${kullananlar.length} takımda kullanılıyor, silinemez` })149    }150    veri.sampiyonlar = veri.sampiyonlar.filter((s) => s !== ad)151    await veriyiYaz(veri)152    res.status(204).end()153})

• degistir küçük bir yardımcı: eski ada denk gelen adı yenisiyle, ötekileri olduğu gibi döndürür. Hem havuzda hem takımlarda aynı fonksiyonu kullanıyoruz.
• Silme, şampiyonu kullanan bir takım varsa reddediliyor; yoksa bir takım havuzda olmayan bir şampiyonla kalırdı.

#404 ve hata yakalayıcı

155app.use((req, res) => {156    res.status(404).json({ hata: "Böyle bir uç nokta yok" })157})158 159app.use((hata, req, res, next) => {160    if (hata.type === "entity.parse.failed") {161        return res.status(400).json({ hata: "Gövde geçerli bir JSON değil" })162    }163    console.error(hata)164    res.status(500).json({ hata: "Sunucuda bir hata oldu" })165})

• İlki, hiçbir route'a uymayan istekleri yakalar. Route'ların hepsinden sonra durduğu için oraya ancak eşleşmeyen istekler düşer.
• İkincisi hata yakalayıcı: dört parametresi olduğu için Express onu sıradan bir ara katman değil, hata yakalayıcı sayar. Express 5'te async bir route'un içinde fırlayan hata da kendiliğinden buraya gelir.
• express.json() bozuk bir gövdeyle karşılaşınca type alanı "entity.parse.failed" olan bir hata fırlatır. Bu bizim hatamız değil, istemcinin; o yüzden 400.
• Geri kalan her şey beklenmeyen bir hatadır. Ayrıntıyı istemciye değil, loga yazıyoruz: hatanın içinde dosya yolları ve kodundan parçalar olabilir, bunları dışarıya göstermek saldırgana ipucu verir. İstemci yalnız "bir hata oldu" duyar.

#Sunucuyu başlatmak

167app.listen(port, (hata) => {168    if (hata) {169        throw hata170    }171    console.log(`Takım API'si çalışıyor: http://localhost:${port}`)172    console.log(`Veri dosyası: ${veriDosyasi}`)173    if (saltOkunur) {174        console.log("Salt okunur: GET dışındaki istekler 503 alacak")175    }176})

Başlarken ayarları loga yazmak iyi bir alışkanlık: yayındaki programın hangi ayarlarla çalıştığını tek bakışta görürsün. Gizli bilgileri (şifre, anahtar) ise asla loga yazma; loglar da başkalarının gözüne girebilir.

app.listen(port, () => {    console.log(`Takım API'si çalışıyor: http://localhost:${port}`)    console.log(`Veri dosyası: ${veriDosyasi}`)})

PS C:\kod\takim-api> node --env-file=.env sunucu.jsTakım API'si çalışıyor: http://localhost:3000Veri dosyası: C:\kod\takim-api\veri.json

PS C:\kod\takim-api> node --env-file=.env sunucu.jsfile:///C:/kod/takim-api/sunucu.js:169        throw hata        ^ Error: listen EADDRINUSE: address already in use :::3000    at Server.setupListenHandle [as _listen2] (node:net:2324:16)    ...  code: 'EADDRINUSE',  errno: -4091,  syscall: 'listen',  address: '::',  port: 3000} Node.js v24.20.0

Dosya tamam. Sunucuyu npm run dev ile başlat:

1import express from "express"2import { readFile, writeFile } from "node:fs/promises"3import { resolve } from "node:path"4import { adHatasi, takimHatasi, sampiyonHatasi } from "./dogrula.js"5 6const app = express()7const port = process.env.PORT ?? 30008const veriDosyasi = resolve(import.meta.dirname, process.env.VERI_DOSYASI ?? "veri.json")9const saltOkunur = process.env.SALT_OKUNUR === "evet"10 11async function veriyiOku() {12    const metin = await readFile(veriDosyasi, "utf8")13    return JSON.parse(metin)14}

PS C:\kod\takim-api> npm run dev > takim-api@1.0.0 dev> node --watch --env-file=.env sunucu.js Takım API'si çalışıyor: http://localhost:3000Veri dosyası: C:\kod\takim-api\veri.json

#Projenin ilk kaydı

Uçları denemeden önce projeyi Git'e kaydet. Denemeler veri.json'u değiştirecek; kayıtta temiz hâli dursun ki sonra ona dönebilesin. Komutları ikinci bir terminalde yaz (terminal panelindeki +), sunucu birincide açık kalsın:

#Bütün uçları dene

Sunucu birinci terminalde açık; istekleri ikincisinden at. Yazma isteklerinde Invoke-RestMethod kullanıyoruz: JSON'u PowerShell'in kendi metni olarak gönderdiği için Ders 26'daki tırnak sorunu çıkmaz. -ContentType'ın sonundaki charset=utf-8'i unutma; Türkçe harfler onunla doğru gider.

#Okumak

PS C:\kod\takim-api> (Invoke-RestMethod http://localhost:3000/api/takimlar) | Select-Object id, ad id ad-- -- 1 Gece Kurtları 2 Mavi Ejderler 3 Baron Avcıları 4 Kuzey Rüzgarı 5 Ateş Kuşları 6 Kurt Sürüsü PS C:\kod\takim-api> curl.exe http://localhost:3000/api/takimlar/3{"id":3,"ad":"Baron Avcıları","olusturulma":"2026-09-03T20:00:00.000Z","oyuncular":[{"kullaniciAdi":"kaan","rol":"orman"},{"kullaniciAdi":"zeynep","rol":"üst"}],"sampiyonlar":["Yasuo","Lee Sin"]}PS C:\kod\takim-api> curl.exe -i http://localhost:3000/api/takimlar/99HTTP/1.1 404 Not FoundX-Powered-By: ExpressContent-Type: application/json; charset=utf-8Content-Length: 29ETag: W/"1d-dROtwCE5hGBhioJB963Igac7VbI"Date: Sun, 11 Oct 2026 18:17:42 GMTConnection: keep-aliveKeep-Alive: timeout=5 {"hata":"Takım bulunamadı"}

Select-Object id, ad her takımdan yalnız iki alanı tablo yapar. Baştaki parantezlere dikkat; neden gerektiğini aşağıdaki hata kartında göreceksin. Content-Length: 29 gövdenin bayt sayısı: {"hata":"Takım bulunamadı"} 27 karakter, ama içindeki iki ı harfinin her biri UTF-8'de 2 bayt tuttuğu için 29 bayt.

PS C:\kod\takim-api> Invoke-RestMethod http://localhost:3000/api/takimlar | Select-Object id, ad id ad-- --  

#Takım eklemek, değiştirmek, silmek

PS C:\kod\takim-api> Invoke-RestMethod -Method Post -Uri http://localhost:3000/api/takimlar -ContentType "application/json; charset=utf-8" -Body '{"ad": "Gölge Takımı", "oyuncular": [{"kullaniciAdi": "baris", "rol": "orman"}], "sampiyonlar": ["Vi", "Zed"]}' id          : 7ad          : Gölge Takımıolusturulma : 2026-10-11T18:17:42.853Zoyuncular   : {@{kullaniciAdi=baris; rol=orman}}sampiyonlar : {Vi, Zed} PS C:\kod\takim-api> Invoke-RestMethod -Method Post -Uri http://localhost:3000/api/takimlar -ContentType "application/json; charset=utf-8" -Body '{"ad": "G"}'Invoke-RestMethod : {"hata":"ad 2 ile 40 karakter arasında olmalı"}At line:1 char:1...PS C:\kod\takim-api> Invoke-RestMethod -Method Post -Uri http://localhost:3000/api/takimlar -ContentType "application/json; charset=utf-8" -Body '{"ad": "Gölge Ordusu", "sampiyonlar": ["Zed", "Zedd"]}'Invoke-RestMethod : {"hata":"Zedd şampiyon havuzunda yok"}At line:1 char:1...

Yeni takım sonId'den bir fazlasını, 7'yi aldı. olusturulma sende o anın saati olur. Invoke-RestMethod, 4xx alınca hata fırlatır ve gövdeyi hata mesajı olarak gösterir (Ders 26); bu yüzden API'nin açıklaması ilk satırda okunuyor.

Kısalttığımız satırlar (At line:1 char:1 ile başlayan blok) PowerShell'in hatanın komutun neresinde olduğunu gösteren kısmı. Sonra takımın adını değiştir ve onu sil:

PS C:\kod\takim-api> Invoke-RestMethod -Method Patch -Uri http://localhost:3000/api/takimlar/7 -ContentType "application/json; charset=utf-8" -Body '{"ad": "Gölge Ordusu"}' id          : 7ad          : Gölge Ordusuolusturulma : 2026-10-11T18:17:42.853Zoyuncular   : {@{kullaniciAdi=baris; rol=orman}}sampiyonlar : {Vi, Zed} PS C:\kod\takim-api> curl.exe -i -X DELETE http://localhost:3000/api/takimlar/7HTTP/1.1 204 No ContentX-Powered-By: ExpressDate: Sun, 11 Oct 2026 18:17:42 GMTConnection: keep-aliveKeep-Alive: timeout=5 

204 No Content'te gövde yok, Content-Type başlığı da yok. Aynı komutu bir kez daha çalıştırırsan takım artık olmadığı için 404 alırsın.

#Şampiyon havuzu

PS C:\kod\takim-api> curl.exe http://localhost:3000/api/sampiyonlar["Ahri","Annie","Brand","Garen","Jinx","Lee Sin","Lux","Morgana","Sona","Teemo","Thresh","Vi","Yasuo","Zed"]PS C:\kod\takim-api> Invoke-RestMethod -Method Post -Uri http://localhost:3000/api/sampiyonlar -ContentType "application/json; charset=utf-8" -Body '{"ad": "Karma"}' ad--Karma PS C:\kod\takim-api> Invoke-RestMethod -Method Post -Uri http://localhost:3000/api/sampiyonlar -ContentType "application/json; charset=utf-8" -Body '{"ad": "lux "}'Invoke-RestMethod : {"hata":"lux zaten havuzda"}At line:1 char:1...PS C:\kod\takim-api> Invoke-RestMethod -Method Patch -Uri http://localhost:3000/api/sampiyonlar/Lux -ContentType "application/json; charset=utf-8" -Body '{"ad": "Luxanna"}' eskiAd yeniAd  takimSayisi------ ------  -----------Lux    Luxanna           2 PS C:\kod\takim-api> curl.exe http://localhost:3000/api/takimlar/1{"id":1,"ad":"Gece Kurtları","olusturulma":"2026-09-01T18:30:00.000Z","oyuncular":[{"kullaniciAdi":"deniz","rol":"orta"},{"kullaniciAdi":"ece","rol":"destek"}],"sampiyonlar":["Ahri","Luxanna","Garen"]}PS C:\kod\takim-api> curl.exe -X DELETE http://localhost:3000/api/sampiyonlar/Annie{"hata":"Annie 2 takımda kullanılıyor, silinemez"}PS C:\kod\takim-api> curl.exe -X DELETE http://localhost:3000/api/sampiyonlar/Morgana

• "lux " ile "Lux" aynı sayıldı; havuza ikinci bir Lux girmedi.
• Lux'ın adı iki takımda birden değişti; 1 numaralı takımın listesinde artık Luxanna var.
• Annie iki takımda kullanıldığı için silinmedi. Morgana'yı hiçbir takım seçmemişti; silindi ve 204 geldiği için curl.exe hiçbir şey yazmadı.

#Bozuk istekler

PS C:\kod\takim-api> curl.exe --json "{" http://localhost:3000/api/takimlar{"hata":"Gövde geçerli bir JSON değil"}PS C:\kod\takim-api> curl.exe http://localhost:3000/api/esyalar{"hata":"Böyle bir uç nokta yok"}

İkisinde de sunucu çökmedi ve istemciye ne yanlış olduğunu söyledi.

#Sunucunun logu

Şimdi birinci terminale bak. Attığın her istek için bir satır var:

GET /api/takimlar 200 6 msGET /api/takimlar/3 200 1 msGET /api/takimlar/99 404 1 msPOST /api/takimlar 201 12 msPOST /api/takimlar 400 2 msPOST /api/takimlar 400 1 msPATCH /api/takimlar/7 200 2 msDELETE /api/takimlar/7 204 2 msGET /api/sampiyonlar 200 2 msPOST /api/sampiyonlar 201 14 msPOST /api/sampiyonlar 400 2 msPATCH /api/sampiyonlar/Lux 200 4 msGET /api/takimlar/1 200 2 msDELETE /api/sampiyonlar/Annie 400 4 msDELETE /api/sampiyonlar/Morgana 204 2 msPOST /api/takimlar 400 2 msGET /api/esyalar 404 1 ms

Invoke-RestMethod'un sana göstermediği durum kodları burada: takım eklemek 201, silmek 204 döndü. Son sütundaki süreler sende farklı çıkar; aynı istek bile her seferinde birkaç milisaniye oynar. Yayında bu satırlar Render'ın log sayfasına akacak.

#Veriyi eski hâline döndür

Denemeler veri.json'u değiştirdi. Git ne değiştiğini biliyor:

PS C:\kod\takim-api> git statusOn branch masterChanges not staged for commit:  (use "git add <file>..." to update what will be committed)  (use "git restore <file>..." to discard changes in working directory)	modified:   veri.json no changes added to commit (use "git add" and/or "git commit -a")PS C:\kod\takim-api> git restore veri.jsonPS C:\kod\takim-api> git statusOn branch masternothing to commit, working tree clean

Git'in ipucundaki git restore <file> komutu, dosyayı son kayıttaki hâline döndürür. Bu kayıtta olmayan değişiklikleri geri dönüşsüz siler; kendi yazdığın bir kod dosyasında kullanmadan önce iki kez düşün. Burada istediğimiz tam bu: deneme verisi gitti, Karma havuzdan çıktı, Lux'ın adı geri geldi. Sunucu her istekte dosyayı baştan okuduğu için yeniden başlatmana gerek yok.

#README: API belgesi

API'ni kullanacak kişi kodunu okumayacak; hangi adrese, hangi gövdeyle istek atacağını ve ne cevap alacağını bilmek isteyecek. Altı ay sonra sen de kendi API'nin ayrıntılarını unutmuş olacaksın. Bu bilgiyi README'ye yaz. Bir API belgesinin olmazsa olmazları: kurulum, ayarlar, uç nokta tablosu, en az bir örnek istek ve yanıt, hata biçimi ve bilinen sınırlar.

Proje klasöründe README.md adında bir dosya aç. Kopyalamak yerine kendi cümlelerinle yaz; aşağıdaki bir örnek:

1# Takım API'si2 3Takımları, oyuncularını ve şampiyon havuzunu tutan küçük bir REST API. Express 5 ile yazıldı, veriyi `veri.json` dosyasında saklar.4 5Canlı adres: https://takim-api-XXXX.onrender.com (ücretsiz plan: 15 dakika istek gelmezse uyur, ilk istek yaklaşık bir dakika sürebilir)6 7## Kurulum8 91. `npm install`102. `.env` dosyası oluştur (aşağıdaki ayarlar)113. `npm run dev`12 13## Ayarlar14 15| Değişken | Varsayılan | Ne işe yarar |16|---|---|---|17| `PORT` | `3000` | Sunucunun dinlediği port. Barındırıcı kendisi verir. |18| `VERI_DOSYASI` | `veri.json` | Verinin tutulduğu dosya |19| `SALT_OKUNUR` | (boş) | `evet` yazılırsa GET dışındaki istekler 503 alır |20 21## Uç noktalar22 23| Yöntem | Yol | Ne yapar | Başarılı yanıt |24|---|---|---|---|25| GET | `/api/takimlar` | Bütün takımları listeler | 200 |26| GET | `/api/takimlar/:id` | Tek takımı getirir | 200 |27| POST | `/api/takimlar` | Yeni takım ekler | 201 |28| PATCH | `/api/takimlar/:id` | Takımın adını değiştirir | 200 |29| DELETE | `/api/takimlar/:id` | Takımı siler | 204 |30| GET | `/api/sampiyonlar` | Şampiyon havuzunu listeler | 200 |31| POST | `/api/sampiyonlar` | Havuza şampiyon ekler | 201 |32| PATCH | `/api/sampiyonlar/:ad` | Şampiyonun adını her yerde değiştirir | 200 |33| DELETE | `/api/sampiyonlar/:ad` | Hiçbir takımda olmayan şampiyonu siler | 204 |34 35## Örnek: takım eklemek36 37İstek: `POST /api/takimlar`, başlık `Content-Type: application/json`38 39```json40{41  "ad": "Gölge Takımı",42  "oyuncular": [{ "kullaniciAdi": "baris", "rol": "orman" }],43  "sampiyonlar": ["Vi", "Zed"]44}45```46 47Yanıt: `201 Created`48 49```json50{51  "id": 7,52  "ad": "Gölge Takımı",53  "olusturulma": "2026-10-11T18:17:42.853Z",54  "oyuncular": [{ "kullaniciAdi": "baris", "rol": "orman" }],55  "sampiyonlar": ["Vi", "Zed"]56}57```58 59Kurallar: `ad` 2–40 karakter; en çok 5 oyuncu, `rol` şunlardan biri: `üst`, `orman`, `orta`, `alt`, `destek`; en çok 5 şampiyon, hepsi havuzda olmalı ve tekrar etmemeli.60 61## Hatalar62 63Hata yanıtlarının hepsi aynı biçimdedir: `{ "hata": "açıklama" }`64 65| Kod | Ne zaman |66|---|---|67| 400 | Gövde bozuk ya da kurala uymuyor |68| 404 | Takım, şampiyon ya da adres yok |69| 500 | Sunucuda beklenmeyen hata (loglara bak) |70| 503 | API salt okunur kipte |71 72## Sınırlar73 74Veri bir JSON dosyasında durur. Ücretsiz barındırıcıda sunucu yeniden başlayınca ya da yeni sürüm yüklenince dosyadaki değişiklikler kaybolur; kalıcı veri için veritabanına geçilecek.

• Uç nokta tablosu belgenin kalbi: her satırda yöntem, yol, ne yaptığı ve başarılı yanıtın kodu. :id ve :ad "buraya bir değer gelir" demek; Express'teki yazımın aynısı.
• Örnek istek ve yanıt, kuralları tek tek anlatmaktan çoğu zaman daha öğreticidir. Örnekteki yanıtı uydurma, gerçekten aldığın yanıtı koy; biz yukarıdaki POST'un çıktısını kullandık.
• Hata biçimi: API'yi kullanan program hataları tek bir yoldan okuyabilmeli. Bizimkinde her hata { "hata": "..." }.
• Sınırlar: API'nin yapamadıklarını saklama; verinin kaybolabileceğini bilen biri ona göre davranır.
• Canlı adresi yayına aldıktan sonra yazacaksın. XXXX şimdilik yer tutucu.

VS Code'da Ctrl+Shift+V README'nin önizlemesini açar; tabloların düzgün göründüğüne bak. Sonra kaydet:

PS C:\kod\takim-api> git add .PS C:\kod\takim-api> git commit -m "README: API belgesi"[master e060511] README: API belgesi 1 file changed, 74 insertions(+) create mode 100644 README.md

#GitHub'a gönder

Render kodunu GitHub'dan alacak. GitHub'da takim-api adında yeni bir depo aç; README, .gitignore ve lisans seçeneklerini boş bırak, bunlar sende zaten var (Ders 25'teki gibi). Herkese açık (Public) ya da gizli (Private) olabilir; Render ikisinden de yayına alır. Sonra GitHub'ın gösterdiği komutlarla gönder; KULLANICI yerine kendi kullanıcı adını yaz:

PS C:\kod\takim-api> git branch -M mainPS C:\kod\takim-api> git remote add origin https://github.com/KULLANICI/takim-api.gitPS C:\kod\takim-api> git push -u origin main# İlk gönderimde tarayıcıda GitHub'a giriş isteyebilir (Ders 7'deki gibi).

GitHub'daki depo sayfasını yenile: altı dosyan ve README'nin önizlemesi orada olmalı. .env olmamalı. Varsa hemen sil, .gitignore'u düzelt ve içinde gizli bir şey varsa değiştir (Ders 29'daki kural: sızan anahtar yenilenir).

#Yayın provası: temiz bir kopyada dene

Render senin klasörünü görmeyecek. GitHub'daki deponun temiz bir kopyasını alacak, içinde npm install ve npm start çalıştıracak. Kopyada node_modules olmayacak, .env olmayacak, Git'e girmemiş hiçbir dosya olmayacak. "Bende çalışıyordu" hatalarının çoğu bu farktan çıkar.

Bu farkı yayından önce kendi bilgisayarında yakalayabilirsin: depoyu başka bir klasöre klonla ve Render'ın yapacağını sırayla yap. Önce sunucunu birinci terminalde Ctrl+C ile durdur. Sonra ikinci terminalde:

PS C:\kod\takim-api> cd ..PS C:\kod> git clone takim-api provaCloning into 'prova'...done.PS C:\kod> cd provaPS C:\kod\prova> npm start > takim-api@1.0.0 start> node sunucu.js node:internal/modules/package_json_reader:301  throw new ERR_MODULE_NOT_FOUND(packageName, fileURLToPath(base), null);        ^ Error [ERR_MODULE_NOT_FOUND]: Cannot find package 'express' imported from C:\kod\prova\sunucu.js    at Object.getPackageJSONURL (node:internal/modules/package_json_reader:301:9)    ...  code: 'ERR_MODULE_NOT_FOUND'} Node.js v24.20.0

git clone takim-api prova yerel depoyu prova adlı yeni bir klasöre kopyaladı; GitHub'dan klonlamak da aynı sonucu verirdi. İlk deneme bilerek erken: paketleri kurmadan başlatırsan ne olacağını gör.

Şimdi Render'ın sırasıyla devam et: önce paketleri kur, sonra Render'ın vereceği portla başlat. Render, programına PORT ortam değişkeninde 10000 verir. $env:PORT = "10000", bu değişkeni yalnız bu terminal için tanımlar:

PS C:\kod\prova> npm install added 65 packages, and audited 66 packages in 2s 28 packages are looking for funding  run `npm fund` for details found 0 vulnerabilitiesPS C:\kod\prova> $env:PORT = "10000"PS C:\kod\prova> npm start > takim-api@1.0.0 start> node sunucu.js Takım API'si çalışıyor: http://localhost:10000Veri dosyası: C:\kod\prova\veri.json

Program .env olmadan da açıldı ve portu ortamdan aldı. Üçüncü bir terminal açıp dene:

PS C:\kod> curl.exe http://localhost:10000/api/takimlar/1{"id":1,"ad":"Gece Kurtları","olusturulma":"2026-09-01T18:30:00.000Z","oyuncular":[{"kullaniciAdi":"deniz","rol":"orta"},{"kullaniciAdi":"ece","rol":"destek"}],"sampiyonlar":["Ahri","Lux","Garen"]}

Prova geçti: temiz kopya kuruluyor, başlıyor ve yanıt veriyor. Sunucuyu Ctrl+C ile durdur ve prova terminalini kapat (terminal listesindeki çöp kutusu simgesi). $env:PORT yalnız o terminalde tanımlıydı, onunla birlikte gider. C:\kod\prova klasörünü de Dosya Gezgini'nden silebilirsin.

Provada çıkabilecek bir hata daha var. Bir dosyayı Git'e eklemeyi unuttuysan klon onu içermez:

PS C:\kod\prova> node sunucu.jsnode:internal/modules/esm/resolve:272    throw new ERR_MODULE_NOT_FOUND(          ^ Error [ERR_MODULE_NOT_FOUND]: Cannot find module 'C:\kod\prova\dogrula.js' imported from C:\kod\prova\sunucu.js    at finalizeResolution (node:internal/modules/esm/resolve:272:11)    ...  code: 'ERR_MODULE_NOT_FOUND',  url: 'file:///C:/kod/prova/dogrula.js'} Node.js v24.20.0

#Render'a yayına almak

Prova geçtiyse yayına hazırsın. Aşağıdaki adımlar Ekim 2026'daki Render belgelerine göre yazıldı.

• Root Directory boş kalıyor, çünkü package.json deponun kökünde. Proje deponun bir alt klasöründe olsaydı onun adını yazardın.
• Build Command paketleri kurar: provadaki npm install. Start Command programı başlatır: provadaki npm start.
• Node sürümünü package.json'daki engines söylüyor; Render'ın yeni servisler için varsayılanı da bu ders yazılırken 24'tü.

Render'ın yayın sırasında yaptıkları:

Dördüncü adım önemli: Render programının bir portu dinlemeye başladığını görmeden yayını tamamlanmış saymaz. Bunun için programın 0.0.0.0 adresinde, yani bilgisayarın bütün ağ adreslerinde dinlemesi gerekir.

app.listen(port)'a adres vermezsen zaten bütün adresleri dinler: yukarıdaki EADDRINUSE mesajındaki address: '::' bunu söylüyordu. app.listen(port, "localhost") yazsaydın program yalnız kendi içinden gelen istekleri kabul eder, Render ona ulaşamazdı. Belgesine göre programın başka bir portu dinlerse Render çoğu zaman onu da bulur; yine de doğru yol process.env.PORT'u kullanmak.

Yayın bitince canlı adresini dene. XXXX yerine kendi adresini yaz:

curl.exe https://takim-api-XXXX.onrender.com/api/takimlar/1

Yanıtın, provadaki curl.exe çıktısıyla harfi harfine aynı olmalı: yayındaki program, provada çalıştırdığın programın ta kendisi. README'deki XXXX'i de gerçek adresinle değiştir.

Sonra curl.exe -i ile başlıklara da bak. Express'in başlıklarına Render'ınkiler eklenir. Aşağıdaki çıktı, Render'ın belgelerindeki örnek Express uygulamasından (express.onrender.com); sayfanın HTML gövdesini kestik:

PS C:\kod> curl.exe -i https://express.onrender.comHTTP/1.1 200 OKDate: Mon, 12 Oct 2026 00:16:32 GMTContent-Type: text/html; charset=utf-8Transfer-Encoding: chunkedConnection: keep-alivecf-cache-status: DYNAMICetag: W/"68e-VaTXc2PRFPGatiGUiAAczSjuh6s"rndr-id: b11a01d4-7bed-4b33Server: cloudflarevary: Accept-Encodingx-powered-by: Expressx-render-origin-server: RenderCF-RAY: a491ea9c0fa33101-ISTalt-svc: h3=":443"; ma=86400

• x-powered-by: Express ve etag programın kendi başlıkları; yolda adları küçük harfe çevrilmiş. Ders 26'dan hatırla: başlık adlarında büyük-küçük harf fark etmez.
• x-render-origin-server: Render ve rndr-id Render'ın; rndr-id'yi birazdan istek kimliği konusunda tekrar göreceksin.
• Server: cloudflare, CF-RAY ve cf-cache-status, Render'ın önünde duran Cloudflare ağından geliyor. CF-RAY'in sonundaki IST, isteğin İstanbul'daki bir Cloudflare sunucusundan geçtiğini söylüyor; sende başka bir kod çıkabilir.
• Windows'un curl.exe'si HTTP'nin yeni sürümü HTTP/2'yi konuşmadığı için yanıt satırı https adreste de HTTP/1.1 ile başlar.

#Ortam değişkenlerini barındırıcıya girmek

Kendi bilgisayarında ayarlar .env'den geliyordu. Render'da .env yok; değişkenleri ya Render kendisi verir ya da sen panelden girersin.

Panelin nasıl çalıştığını zararsız bir ayarla dene: yayındaki API'ni salt okunur yap.

Kaydetme menüsündeki üç seçenek:

• Save, rebuild, and deploy: baştan derler (npm install dahil) ve yayınlar.
• Save and deploy: var olan derlemeyi yeni değişkenlerle yeniden başlatır. Yalnız bir değişken değiştirdiysen yeterli ve daha hızlı.
• Save only: kaydeder ama yayınlamaz. Değişken bir sonraki yayına kadar etkisizdir; bu yüzden "değiştirdim ama bir şey olmadı" sorusunun en sık cevabı budur.

Yayın bitince bir yazma isteği dene. Aşağıdaki çıktıları provadaki gibi kendi bilgisayarımızda, aynı değişkenle aldık; canlı adreste gövde aynıdır:

PS C:\kod\takim-api> curl.exe -i -X DELETE https://takim-api-XXXX.onrender.com/api/takimlar/1HTTP/1.1 503 Service UnavailableX-Powered-By: ExpressContent-Type: application/json; charset=utf-8Content-Length: 33ETag: W/"21-+2OXKDulu7CLsBVwT/Z62s6iFwg"Date: Sun, 11 Oct 2026 18:18:56 GMTConnection: keep-aliveKeep-Alive: timeout=5 {"hata":"API şu an salt okunur"}PS C:\kod\takim-api> curl.exe https://takim-api-XXXX.onrender.com/api/takimlar/1{"id":1,"ad":"Gece Kurtları","olusturulma":"2026-09-01T18:30:00.000Z","oyuncular":[{"kullaniciAdi":"deniz","rol":"orta"},{"kullaniciAdi":"ece","rol":"destek"}],"sampiyonlar":["Ahri","Lux","Garen"]}

Silme reddedildi, okuma çalışıyor. Logun başında da program durumu söyler:

Takım API'si çalışıyor: http://localhost:10000Veri dosyası: C:\kod\takim-api\veri.jsonSalt okunur: GET dışındaki istekler 503 alacakDELETE /api/takimlar/1 503 4 msGET /api/takimlar/1 200 4 ms

Render'da Veri dosyası satırında Windows yolu yerine bir Linux yolu görürsün; localhost:10000 da Render'ın içinden bakınca doğru. İstersen değişkeni silip (Environment sayfasında satırın yanındaki çöp kutusu) yazmayı yeniden aç.

#Loglara bakmak, canlıda hata ayıklamak

Yayındaki API'de hata olduğunda terminal yok, hata ayıklayıcı yok. Elinde iki şey var: isteği kendin tekrarlamak ve logları okumak. Render'da iki ayrı log yeri var:

• Deploys: her yayının kendi çıktısı. Klonlama, npm install'ın yazdıkları ve npm start'ın ilk satırları burada. Yayın başarısız olduysa sebebi buradadır.
• Logs: çalışan programın yazdıkları: kayıt ara katmanının satırları, console.error ile yazılan hatalar. Program çalıştığı sürece akar.

• Sayfa varsayılan olarak son bir saati gösterir; sağ üstteki menüden aralığı değiştirirsin. Live tail satırları geldikleri anda akıtır: bir isteği atıp sonucunu canlı izlemek için.
• Arama kutusuna yazdığın metin (500, bir yol, bir istek kimliği) yalnız onu içeren satırları bırakır.
• Ücretsiz Hobby çalışma alanında loglar 7 gün saklanır. Pro ve üstü çalışma alanlarında Render her isteği kendisi de loglar; Hobby'de o satırlar yok, bu yüzden kendi kayıt ara katmanını yazdın.

#Hangi istek hangi satır? İstek kimliği

Aynı anda onlarca istek gelirken log satırları birbirine karışır. Bir kullanıcı "biraz önce hata aldım" dediğinde onun isteğini bulmak zordur. Çözüm, her isteğe kısa bir ad vermek:

Ders 26'da httpbin'in yanıtlarında X-Amzn-Trace-Id diye bir başlık görmüştün; Amazon'un istek kimliği. Render da aynı fikri kullanıyor: canlı adresin başlıklarında gördüğün rndr-id Render'ın istek kimliği. Render onu hem yanıtla istemciye hem de isteğin başlığında senin programına gönderir; Pro çalışma alanlarındaki istek loglarının her satırında da aynı kimlik requestID adıyla durur. Kendi API'ne istek kimliği eklemek dördüncü görevin.

#Canlıda hata ayıklamanın altı adımı

Yayında en sık karşılaşacağın üç durum:

PS C:\kod\takim-api> npm startnpm error Missing script: "start"npm errornpm error Did you mean one of these?npm error   npm star # Mark your favorite packagesnpm error   npm stars # View packages marked as favoritesnpm errornpm error To see a list of scripts, run:npm error   npm runnpm error A complete log of this run can be found in: C:\Users\Deniz\AppData\Local\npm-cache\_logs\2026-10-11T18_13_01_490Z-debug-0.log

SyntaxError: Unexpected end of JSON input    at JSON.parse (<anonymous>)    at veriyiOku (file:///C:/kod/takim-api/sunucu.js:13:17)    at async file:///C:/kod/takim-api/sunucu.js:39:18GET /api/takimlar 500 8 ms

Üçüncü durumda hiçbir hata mesajı yok:

#Alan adı ve DNS kayıtları

Adresin şu an takim-api-XXXX.onrender.com. Çalışır, ama akılda kalmaz ve Render'ın adını taşır. Kendi alan adın varsa API'ni api.alanadin.com gibi bir adrese bağlayabilirsin.

Ders 18'den hatırla: DNS internetin rehberi; tarayıcı bir adı önce DNS'e sorar, aldığı numaraya bağlanır. Rehberdeki her satıra DNS kaydı denir. Her kaydın bir türü, bir adı ve bir değeri vardır.

Alan adı Ders 18'de gördüğün gibi yıllık ücretle kiralanır. Bu bölümü uygulamak için bir alan adı satın alman gerekir; almayacaksan okuyup geç, onrender.com adresin ücretsiz ve yeterli. Örneklerde, tam bu iş için ayrılmış example.com'u kullanıyoruz; sen kendi alan adını yazacaksın.

Render aynı IP adresinde binlerce servisi barındırır. Bir isteği hangi servise vereceğini, tarayıcının Ders 26'da gördüğün Host başlığına yazdığı addan anlar. Bu yüzden DNS kaydı tek başına yetmez: adı Render'a da söylemen gerekir. Birazdan göreceğin Custom Domains adımı bu işe yarar.

Rehbere kendin de sorabilirsin. nslookup CNAME'leri Aliases (takma adlar) satırında gösterir:

PS C:\kod> nslookup www.github.comServer:  dns.googleAddress:  2001:4860:4860::8888 Non-authoritative answer:Name:    github.comAddress:  140.82.121.4Aliases:  www.github.com PS C:\kod> nslookup express.onrender.comServer:  dns.googleAddress:  2001:4860:4860::8888 Non-authoritative answer:Name:    gcp-us-west1-1.origin.onrender.com.cdn.cloudflare.netAddresses:  216.24.57.16	  216.24.57.18Aliases:  express.onrender.com	  gcp-us-west1-1.origin.onrender.com

• www.github.com bir CNAME: github.com'a yönlendiriyor, onun A kaydı da bir IP adresi veriyor.
• express.onrender.com, Render'ın belgelerindeki örnek Express uygulaması. Onun adı da iki CNAME'den geçip Render'ın 216.24.57.x adreslerine varıyor. Senin onrender.com adresin de böyle çalışır.
• Numaralar ve sunucu adları zamanla değişebilir; sende farklı çıkarsa sorun değil.

Her kaydın bir de TTL'si vardır: Ders 30'da önbellek için gördüğün yaşam süresi. DNS'te bu, cevabı alanların onu kaç saniye hatırlayabileceğini söyler. Bir kaydı değiştirdiğinde eski cevabı hatırlayanlar TTL dolana kadar eskisini kullanır. "DNS'i değiştirdim ama hâlâ eski yere gidiyor" şikâyetinin sebebi budur. PowerShell'in Resolve-DnsName komutu kaydın türünü ve TTL'sini de gösterir:

PS C:\kod> Resolve-DnsName www.github.com -Type CNAME Name                           Type   TTL   Section    NameHost----                           ----   ---   -------    --------www.github.com                 CNAME  3600  Answer     github.com 

#API'ni kendi alan adına bağlamak

Render ücretsiz servislerde de alan adı bağlamaya izin veriyor; ücretsiz çalışma alanında iki alan adı dahil. Sertifikayı da kendisi alıp yeniliyor, yani adresin https ile çalışıyor.

DNS panelinde kayıtlar çoğu zaman şöyle bir tabloyla girilir:

• Ad sütunu alan adının başına eklenecek kısımdır: api yazarsan kayıt api.example.com için olur. @, kök adın kendisi demek.
• Kök ada (example.com) CNAME konamaz; DNS'in kuralı bu. Bu yüzden kök ad için ya şirketlerin CNAME benzeri ANAME/ALIAS kaydı ya da Render'ın belgesinde verdiği IP adresine bir A kaydı kullanılır. Kök adı eklersen Render www alt adını da kendisi ekler ve köke yönlendirir.
• Render'ın belgesi, alan adında AAAA (IPv6) kaydı varsa silmeni istiyor: Render IPv4 kullanıyor.
• Bilgiler Ekim 2026'daki Render belgelerinden; IP adresini ve adımları bağlamadan önce güncel belgeden doğrula.

PS C:\kod> curl.exe https://api.example.com/api/takimlarcurl: (6) Could not resolve host: api.example.comPS C:\kod> Invoke-RestMethod https://api.example.com/api/takimlarInvoke-RestMethod : Uzak ad çözülemedi: 'api.example.com'...

#Görevler

Görevler projeyi büyütüyor; her biri bir öncekinin bıraktığı yerden devam ediyor. Sunucu npm run dev ile açık kalsın, istekleri ikinci terminalden at. Her görevden sonra commit'leyip gönderirsen Render onu da yayına alır. Önce kendin dene, takılırsan ipuçlarını sırayla aç.

{"durum":"iyi","calismaSuresi":4,"surum":"yerel","takimSayisi":6}

app.get("/saglik", async (req, res) => {    const veri = await veriyiOku()    res.json({        durum: "iyi",        calismaSuresi: Math.floor(process.uptime()),        surum: process.env.RENDER_GIT_COMMIT?.slice(0, 7) ?? "yerel",        takimSayisi: veri.takimlar.length    })})

PS C:\kod\takim-api> curl.exe http://localhost:3000/saglik{"durum":"iyi","calismaSuresi":0,"surum":"yerel","takimSayisi":6}PS C:\kod\takim-api> curl.exe http://localhost:3000/saglik{"durum":"iyi","calismaSuresi":4,"surum":"yerel","takimSayisi":6}

1const ad = "Baron Avcıları"2console.log("AVCI".toLowerCase())3console.log("AVCI".toLocaleLowerCase("tr"))4console.log(ad.toLocaleLowerCase("tr").includes("AVCI".toLowerCase()))5console.log(ad.toLocaleLowerCase("tr").includes("AVCI".toLocaleLowerCase("tr")))

avciavcıfalsetrue

app.get("/api/takimlar", async (req, res) => {    const veri = await veriyiOku()    const ara = (req.query.ara ?? "").trim().toLocaleLowerCase("tr")    const bulunanlar = veri.takimlar.filter((t) => t.ad.toLocaleLowerCase("tr").includes(ara))    res.json(bulunanlar)})

PS C:\kod\takim-api> (Invoke-RestMethod "http://localhost:3000/api/takimlar?ara=kurt") | Select-Object id, ad id ad-- -- 1 Gece Kurtları 6 Kurt Sürüsü PS C:\kod\takim-api> (Invoke-RestMethod "http://localhost:3000/api/takimlar?ara=AVCI") | Select-Object id, ad id ad-- -- 3 Baron Avcıları PS C:\kod\takim-api> (Invoke-RestMethod "http://localhost:3000/api/takimlar?ara=KUŞ") | Select-Object id, ad id ad-- -- 5 Ateş Kuşları PS C:\kod\takim-api> (Invoke-RestMethod "http://localhost:3000/api/takimlar?ara=").Count6PS C:\kod\takim-api> curl.exe "http://localhost:3000/api/takimlar?ara=xyz"[]

export function sayfaBilgisi(sorgu) {    const sayfa = Number(sorgu.sayfa ?? 1)    const boyut = Number(sorgu.boyut ?? 10)    if (!Number.isInteger(sayfa) || sayfa < 1) {        return { hata: "sayfa 1 ya da daha büyük bir tam sayı olmalı" }    }    if (!Number.isInteger(boyut) || boyut < 1 || boyut > 50) {        return { hata: "boyut 1 ile 50 arasında bir tam sayı olmalı" }    }    return { sayfa, boyut }}

1function sayfaBilgisi(sorgu) {2    const sayfa = Number(sorgu.sayfa ?? 1)3    const boyut = Number(sorgu.boyut ?? 10)4    if (!Number.isInteger(sayfa) || sayfa < 1) {5        return { hata: "sayfa 1 ya da daha büyük bir tam sayı olmalı" }6    }7    if (!Number.isInteger(boyut) || boyut < 1 || boyut > 50) {8        return { hata: "boyut 1 ile 50 arasında bir tam sayı olmalı" }9    }10    return { sayfa, boyut }11}12 13console.log(sayfaBilgisi({}))14console.log(sayfaBilgisi({ sayfa: "2", boyut: "4" }))15console.log(sayfaBilgisi({ boyut: "50" }))16console.log(sayfaBilgisi({ boyut: "51" }))17console.log(sayfaBilgisi({ sayfa: "0" }))18console.log(sayfaBilgisi({ sayfa: "1.5" }))19console.log(sayfaBilgisi({ sayfa: "" }))20console.log(sayfaBilgisi({ sayfa: ["1", "2"] }))

{ sayfa: 1, boyut: 10 }{ sayfa: 2, boyut: 4 }{ sayfa: 1, boyut: 50 }{ hata: 'boyut 1 ile 50 arasında bir tam sayı olmalı' }{ hata: 'sayfa 1 ya da daha büyük bir tam sayı olmalı' }{ hata: 'sayfa 1 ya da daha büyük bir tam sayı olmalı' }{ hata: 'sayfa 1 ya da daha büyük bir tam sayı olmalı' }{ hata: 'sayfa 1 ya da daha büyük bir tam sayı olmalı' }

app.get("/api/takimlar", async (req, res) => {    const { sayfa, boyut, hata } = sayfaBilgisi(req.query)    if (hata) {        return res.status(400).json({ hata })    }    const veri = await veriyiOku()    const ara = (req.query.ara ?? "").trim().toLocaleLowerCase("tr")    const bulunanlar = veri.takimlar.filter((t) => t.ad.toLocaleLowerCase("tr").includes(ara))    const bas = (sayfa - 1) * boyut    res.set("X-Toplam-Sayi", bulunanlar.length)    res.json(bulunanlar.slice(bas, bas + boyut))})

PS C:\kod\takim-api> curl.exe -i "http://localhost:3000/api/takimlar?ara=kurt&boyut=1"HTTP/1.1 200 OKX-Powered-By: ExpressX-Toplam-Sayi: 2Content-Type: application/json; charset=utf-8Content-Length: 200ETag: W/"c8-MJCga5d6F5AHYGA/IOSzrz/SbcM"Date: Sun, 11 Oct 2026 18:21:01 GMTConnection: keep-aliveKeep-Alive: timeout=5 [{"id":1,"ad":"Gece Kurtları","olusturulma":"2026-09-01T18:30:00.000Z","oyuncular":[{"kullaniciAdi":"deniz","rol":"orta"},{"kullaniciAdi":"ece","rol":"destek"}],"sampiyonlar":["Ahri","Lux","Garen"]}]PS C:\kod\takim-api> (Invoke-RestMethod "http://localhost:3000/api/takimlar?sayfa=2&boyut=4") | Select-Object id, ad id ad-- -- 5 Ateş Kuşları 6 Kurt Sürüsü PS C:\kod\takim-api> curl.exe "http://localhost:3000/api/takimlar?sayfa=3&boyut=4"[]PS C:\kod\takim-api> (Invoke-RestMethod "http://localhost:3000/api/takimlar?boyut=50").Count6PS C:\kod\takim-api> curl.exe "http://localhost:3000/api/takimlar?boyut=51"{"hata":"boyut 1 ile 50 arasında bir tam sayı olmalı"}PS C:\kod\takim-api> curl.exe "http://localhost:3000/api/takimlar?sayfa=0"{"hata":"sayfa 1 ya da daha büyük bir tam sayı olmalı"}PS C:\kod\takim-api> curl.exe "http://localhost:3000/api/takimlar?sayfa=1.5"{"hata":"sayfa 1 ya da daha büyük bir tam sayı olmalı"}PS C:\kod\takim-api> curl.exe "http://localhost:3000/api/takimlar?boyut=abc"{"hata":"boyut 1 ile 50 arasında bir tam sayı olmalı"}

1import { randomUUID } from "node:crypto"2 3const kimlik = randomUUID()4console.log(kimlik)5console.log(kimlik.slice(0, 8))

a05d02a4-b6dc-4f93-a8a3-add99a9b257ca05d02a4

import { randomUUID } from "node:crypto" app.use((req, res, next) => {    req.kimlik = randomUUID().slice(0, 8)    res.set("X-Istek-Kimligi", req.kimlik)    next()})

        console.log(`[${req.kimlik}] ${req.method} ${req.originalUrl} ${res.statusCode} ${sure} ms`)

    console.error(`[${req.kimlik}]`, hata)    res.status(500).json({ hata: "Sunucuda bir hata oldu", istekKimligi: req.kimlik })

PS C:\kod\takim-api> curl.exe -i http://localhost:3000/api/takimlar/2HTTP/1.1 200 OKX-Powered-By: ExpressX-Istek-Kimligi: e45995f5Content-Type: application/json; charset=utf-8Content-Length: 197ETag: W/"c5-N0X+XetqwH8s/PM5iaBuehp8NSg"Date: Sun, 11 Oct 2026 22:45:07 GMTConnection: keep-aliveKeep-Alive: timeout=5 {"id":2,"ad":"Mavi Ejderler","olusturulma":"2026-09-02T09:15:00.000Z","oyuncular":[{"kullaniciAdi":"mert","rol":"alt"},{"kullaniciAdi":"selin","rol":"orman"}],"sampiyonlar":["Jinx","Thresh","Lux"]}PS C:\kod\takim-api> curl.exe -i http://localhost:3000/api/takimlar/99HTTP/1.1 404 Not FoundX-Powered-By: ExpressX-Istek-Kimligi: 8c2e3fc6Content-Type: application/json; charset=utf-8Content-Length: 29ETag: W/"1d-dROtwCE5hGBhioJB963Igac7VbI"Date: Sun, 11 Oct 2026 22:45:07 GMTConnection: keep-aliveKeep-Alive: timeout=5 {"hata":"Takım bulunamadı"}

PS C:\kod\takim-api> curl.exe http://localhost:3000/api/takimlar/1{"hata":"Sunucuda bir hata oldu","istekKimligi":"37172073"}PS C:\kod\takim-api> git restore veri.json

[e45995f5] GET /api/takimlar/2 200 5 ms[8c2e3fc6] GET /api/takimlar/99 404 1 ms[37172073] SyntaxError: Unexpected end of JSON input    at JSON.parse (<anonymous>)    at veriyiOku (file:///C:/kod/takim-api/sunucu.js:14:17)    at async file:///C:/kod/takim-api/sunucu.js:59:18[37172073] GET /api/takimlar/1 500 3 ms

{"hata":"Sunucuda bir hata oldu","istekKimligi":"48364e89"}

[aeea0cf6] GET /api/takimlar?ara=kurt 200 1 ms[48364e89] TypeError: (req.query.ara ?? "").trim is not a function    at file:///C:/kod/takim-api/sunucu.js:51:39[48364e89] GET /api/takimlar?ara=kurt&ara=baron 500 3 ms[62d85dec] GET /api/takimlar?sayfa=1&sayfa=2 400 0 ms

1import { parse } from "node:querystring"2 3console.log(parse("ara=kurt"))4console.log(parse("ara=kurt&ara=baron"))5console.log(typeof parse("ara=kurt&ara=baron").ara)

[Object: null prototype] { ara: 'kurt' }[Object: null prototype] { ara: [ 'kurt', 'baron' ] }object

    if (req.query.ara !== undefined && typeof req.query.ara !== "string") {        return res.status(400).json({ hata: "ara yalnız bir kez yazılmalı" })    }

PS C:\kod\takim-api> curl.exe -i "http://localhost:3000/api/takimlar?ara=kurt&ara=baron"HTTP/1.1 400 Bad RequestX-Powered-By: ExpressX-Istek-Kimligi: ad30649cContent-Type: application/json; charset=utf-8Content-Length: 42ETag: W/"2a-rHTWcl26yjURpu157IYCeWfuzjk"Date: Sun, 11 Oct 2026 18:21:29 GMTConnection: keep-aliveKeep-Alive: timeout=5 {"hata":"ara yalnız bir kez yazılmalı"}PS C:\kod\takim-api> curl.exe "http://localhost:3000/api/takimlar?ara=kurt&boyut=1"[{"id":1,"ad":"Gece Kurtları","olusturulma":"2026-09-01T18:30:00.000Z","oyuncular":[{"kullaniciAdi":"deniz","rol":"orta"},{"kullaniciAdi":"ece","rol":"destek"}],"sampiyonlar":["Ahri","Lux","Garen"]}]

#Kendini sına

POST /api/takimlar 201 12 msTakım API'si çalışıyor: http://localhost:10000Veri dosyası: /opt/render/project/src/veri.jsonGET /api/takimlar/7 404 1 ms