{"id":104,"date":"2026-10-26T17:47:00","date_gmt":"2026-10-26T17:47:00","guid":{"rendered":"https:\/\/www.akifsen.com.tr\/blog\/?p=104"},"modified":"2026-10-26T17:47:00","modified_gmt":"2026-10-26T17:47:00","slug":"http-caching-etag-cache-control-api","status":"publish","type":"post","link":"https:\/\/www.akifsen.com.tr\/blog\/2026\/10\/26\/http-caching-etag-cache-control-api\/","title":{"rendered":"HTTP Cache&#8217;i API&#8217;ler \u0130\u00e7in de Kullan\u0131n: ETag ve Cache-Control"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">HTTP cache denince genellikle statik dosyalar akla gelir. G\u00f6rseller, CSS, JavaScript.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">API cevaplar\u0131 ise \u00e7o\u011fu zaman \u015fu header ile d\u00f6ner:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>Cache-Control: no-store<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Veya hi\u00e7 cache header&#8217;\u0131 olmadan.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Oysa HTTP&#8217;nin cache mekanizmas\u0131, JSON cevaplar i\u00e7in de ayn\u0131 \u015fekilde \u00e7al\u0131\u015f\u0131r. Do\u011fru kullan\u0131ld\u0131\u011f\u0131nda hem sunucu y\u00fck\u00fcn\u00fc hem de mobil kullan\u0131c\u0131lar\u0131n veri t\u00fcketimini ciddi \u015fekilde azaltabilir.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Cache-Control<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">En temel ara\u00e7 <code>Cache-Control<\/code> header&#8217;\u0131.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>Cache-Control: public, max-age=300<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Bu cevap 5 dakika boyunca herkes taraf\u0131ndan, taray\u0131c\u0131lar ve CDN&#8217;ler dahil, cache&#8217;lenebilir.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Kullan\u0131c\u0131ya \u00f6zel veriler i\u00e7in <code>private<\/code> kullan\u0131l\u0131r. B\u00f6ylece sadece kullan\u0131c\u0131n\u0131n taray\u0131c\u0131s\u0131 cache&#8217;ler, aradaki payla\u015f\u0131ml\u0131 cache&#8217;ler cevab\u0131 saklamaz:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>Cache-Control: private, max-age=60<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><code>no-cache<\/code> ismine ra\u011fmen &#8220;cache&#8217;leme&#8221; demek de\u011fildir. &#8220;Cache&#8217;le ama kullanmadan \u00f6nce sunucuya sor&#8221; demektir. Cache&#8217;lenmemesi gereken cevaplar i\u00e7in do\u011fru de\u011fer <code>no-store<\/code>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Bu ayr\u0131m bile bir\u00e7ok projede kar\u0131\u015ft\u0131r\u0131l\u0131yor.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">ETag ve ko\u015fullu istek<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Baz\u0131 kaynaklar i\u00e7in ne kadar s\u00fcre ge\u00e7erli kalaca\u011f\u0131n\u0131 \u00f6nceden bilemezsiniz. \u00dcr\u00fcn bilgisi bir dakika sonra da de\u011fi\u015febilir, bir ay sonra da.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Bu durumda ETag kullan\u0131l\u0131r:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>HTTP\/1.1 200 OK\nETag: \"a7f3c2\"\nCache-Control: no-cache<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Client bir sonraki istekte bu de\u011feri g\u00f6nderir:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>GET \/products\/42\nIf-None-Match: \"a7f3c2\"<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Kaynak de\u011fi\u015fmediyse sunucu g\u00f6vde g\u00f6ndermeden cevap verir:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>HTTP\/1.1 304 Not Modified<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Client elindeki kopyay\u0131 kullan\u0131r. A\u011f \u00fczerinden sadece birka\u00e7 header ge\u00e7er.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">ETag&#8217;i ucuza \u00fcretmek<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Spring&#8217;in <code>ShallowEtagHeaderFilter<\/code> s\u0131n\u0131f\u0131 ETag&#8217;i cevap g\u00f6vdesinin hash&#8217;inden \u00fcretir. Kullan\u0131m\u0131 kolay ama bir s\u0131n\u0131r\u0131 var: sunucu yine b\u00fct\u00fcn i\u015fi yapar, veritaban\u0131 sorgular\u0131n\u0131 \u00e7al\u0131\u015ft\u0131r\u0131r ve JSON&#8217;u \u00fcretir. Sadece a\u011f trafi\u011fi kazan\u0131l\u0131r.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Daha verimli yakla\u015f\u0131m, ETag&#8217;i kayna\u011f\u0131n version bilgisinden \u00fcretmektir:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>ETag: \"product-42-v17\"<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Gelen <code>If-None-Match<\/code> de\u011feri mevcut version ile kar\u015f\u0131la\u015ft\u0131r\u0131l\u0131r. E\u015fle\u015fiyorsa veritaban\u0131ndan t\u00fcm kay\u0131t okunmadan, JSON \u00fcretilmeden 304 d\u00f6n\u00fclebilir.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Optimistic locking i\u00e7in zaten bir <code>version<\/code> kolonu varsa, bu de\u011fer ETag i\u00e7in haz\u0131r bir kaynakt\u0131r. Ayn\u0131 ETag <code>If-Match<\/code> ile g\u00fcncelleme isteklerinde \u00e7ak\u0131\u015fma kontrol\u00fc i\u00e7in de kullan\u0131labilir.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Vary<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Ayn\u0131 URL farkl\u0131 ko\u015fullarda farkl\u0131 cevap veriyorsa, cache&#8217;in bunu bilmesi gerekir:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>Vary: Accept-Language<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Aksi halde T\u00fcrk\u00e7e cevap cache&#8217;lenir ve \u0130ngilizce isteyen kullan\u0131c\u0131ya da o g\u00f6nderilir. <code>Authorization<\/code> header&#8217;\u0131na g\u00f6re de\u011fi\u015fen cevaplar\u0131 payla\u015f\u0131ml\u0131 cache&#8217;lere hi\u00e7 b\u0131rakmamak ise en g\u00fcvenli yol.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Neyi cache&#8217;lememeli?<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Ki\u015fisel veriler, bakiye gibi anl\u0131k do\u011fruluk gereken bilgiler ve yetkiye g\u00f6re de\u011fi\u015fen cevaplar payla\u015f\u0131ml\u0131 cache&#8217;lerde tutulmamal\u0131. Yanl\u0131\u015f konfig\u00fcre edilmi\u015f bir CDN&#8217;in bir kullan\u0131c\u0131n\u0131n hesap bilgisini ba\u015fka bir kullan\u0131c\u0131ya g\u00f6stermesi, cache&#8217;in yol a\u00e7abilece\u011fi en ciddi hatalardan biri.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Varsay\u0131lan\u0131 <code>no-store<\/code> yap\u0131p, cache&#8217;lenebilir oldu\u011fundan emin olunan endpoint&#8217;leri a\u00e7\u0131k\u00e7a i\u015faretlemek bence daha g\u00fcvenli bir ba\u015flang\u0131\u00e7.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">HTTP cache&#8217;i zaten her taray\u0131c\u0131da, her proxy&#8217;de ve her CDN&#8217;de \u00e7al\u0131\u015fan \u00fccretsiz bir altyap\u0131.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">API&#8217;lerin \u00e7o\u011fu bu altyap\u0131dan hi\u00e7 faydalanm\u0131yor.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Her istekte ayn\u0131 JSON&#8217;u ba\u015ftan \u00fcretip g\u00f6ndermek gereksiz. API&#8217;lerde Cache-Control, ETag ve 304 Not Modified ile bant geni\u015fli\u011fi ve sunucu y\u00fck\u00fc nas\u0131l azalt\u0131l\u0131r?<\/p>\n","protected":false},"author":1,"featured_media":103,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[9],"tags":[],"class_list":["post-104","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-api-tasarimi"],"_links":{"self":[{"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/posts\/104","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/comments?post=104"}],"version-history":[{"count":1,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/posts\/104\/revisions"}],"predecessor-version":[{"id":192,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/posts\/104\/revisions\/192"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/media\/103"}],"wp:attachment":[{"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/media?parent=104"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/categories?post=104"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/tags?post=104"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}