{"id":136,"date":"2026-11-01T06:45:00","date_gmt":"2026-11-01T06:45:00","guid":{"rendered":"https:\/\/www.akifsen.com.tr\/blog\/?p=136"},"modified":"2026-11-01T06:45:00","modified_gmt":"2026-11-01T06:45:00","slug":"long-running-operations-202-accepted","status":"publish","type":"post","link":"https:\/\/www.akifsen.com.tr\/blog\/2026\/11\/01\/long-running-operations-202-accepted\/","title":{"rendered":"Uzun S\u00fcren \u0130\u015flemler \u0130\u00e7in API Tasar\u0131m\u0131: 202 Accepted ve Polling"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Bir kullan\u0131c\u0131 y\u0131ll\u0131k sat\u0131\u015f raporu istiyor.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Rapor \u00fcretimi milyonlarca sat\u0131r\u0131 okuyor ve yakla\u015f\u0131k 3 dakika s\u00fcr\u00fcyor.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u0130lk implementasyon genellikle \u015f\u00f6yle:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>POST \/api\/reports\n\u2192 3 dakika bekle\n\u2190 200 OK + rapor<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Geli\u015ftirici ortam\u0131nda \u00e7al\u0131\u015f\u0131yor.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Production&#8217;da ise istek 60. saniyede load balancer taraf\u0131ndan kesiliyor. Kullan\u0131c\u0131 tekrar deniyor. \u015eimdi arka planda ayn\u0131 rapordan iki tane \u00fcretiliyor.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">HTTP iste\u011fi uzun i\u015fler i\u00e7in de\u011fil<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Bir HTTP iste\u011finin yolunda bir\u00e7ok bile\u015fen var: taray\u0131c\u0131, CDN, load balancer, reverse proxy, uygulama sunucusu. Her birinin kendi timeout de\u011feri var ve genellikle bir dakika civar\u0131nda.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Uzun s\u00fcre a\u00e7\u0131k kalan istekler thread ve connection tutar. Deploy s\u0131ras\u0131nda yar\u0131da kesilir. Mobil ba\u011flant\u0131larda kopma ihtimali artar.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Birka\u00e7 saniyeyi ge\u00e7mesi muhtemel i\u015fler i\u00e7in senkron model yerine asenkron bir model daha sa\u011fl\u0131kl\u0131.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">202 Accepted<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">\u0130stek al\u0131nd\u0131\u011f\u0131nda i\u015fi hemen ba\u015flatmak yerine kabul etti\u011finizi s\u00f6ylersiniz:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>POST \/api\/reports\n{ \"year\": 2026 }\n\nHTTP\/1.1 202 Accepted\nLocation: \/api\/operations\/71\n{ \"id\": 71, \"status\": \"queued\" }<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><code>202 Accepted<\/code> HTTP&#8217;nin tam olarak bu durum i\u00e7in tan\u0131mlad\u0131\u011f\u0131 status code. &#8220;\u0130ste\u011fini ald\u0131m, i\u015fleyece\u011fim, ama sonu\u00e7 hen\u00fcz haz\u0131r de\u011fil.&#8221;<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u0130\u015f bir kuyru\u011fa konur ve arka plandaki worker&#8217;lar taraf\u0131ndan i\u015flenir.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Operation kayna\u011f\u0131<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Client i\u015fin durumunu bir kaynak \u00fczerinden takip eder:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>GET \/api\/operations\/71\n\n{\n  \"id\": 71,\n  \"status\": \"running\",\n  \"progress\": 40,\n  \"createdAt\": \"2026-10-26T09:12:00Z\"\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\u0130\u015f bitti\u011finde:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"id\": 71,\n  \"status\": \"succeeded\",\n  \"result\": { \"href\": \"\/api\/reports\/2026-annual\" }\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Hata olursa, hatan\u0131n a\u00e7\u0131klamas\u0131yla birlikte <code>failed<\/code> durumu d\u00f6ner.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Google&#8217;\u0131n API tasar\u0131m rehberi bu yap\u0131ya long-running operation diyor ve bir\u00e7ok bulut API&#8217;si benzer bir model kullan\u0131yor.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Polling s\u0131kl\u0131\u011f\u0131<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Client ne s\u0131kl\u0131kla sormal\u0131?<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Her 100 ms&#8217;de bir sormak sunucuyu gereksiz yere yorar. Her 5 dakikada bir sormak kullan\u0131c\u0131y\u0131 bekletir.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Sunucu bir \u00f6neri verebilir:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>Retry-After: 5<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Client artan aral\u0131klarla sorgulama da yapabilir. \u0130lk birka\u00e7 saniyede s\u0131k, sonra seyrek.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Polling&#8217;in alternatifleri de var. \u0130\u015f bitti\u011finde client&#8217;\u0131n verdi\u011fi bir URL&#8217;ye webhook g\u00f6ndermek, sunucudan sunucuya entegrasyonlarda iyi \u00e7al\u0131\u015f\u0131r. Taray\u0131c\u0131da ise Server-Sent Events veya WebSocket ile durum g\u00fcncellemesi g\u00f6ndermek, kullan\u0131c\u0131ya canl\u0131 bir ilerleme \u00e7ubu\u011fu g\u00f6stermeyi sa\u011flar.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Ama polling her zaman bir yedek olarak kalmal\u0131. Basittir, her client&#8217;ta \u00e7al\u0131\u015f\u0131r ve ba\u011flant\u0131 kopsa bile durum kaybolmaz.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Tekrarlanan istekler<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Kullan\u0131c\u0131 rapor butonuna iki kez bast\u0131. \u0130ki ayr\u0131 i\u015f ba\u015flamal\u0131 m\u0131?<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Bir idempotency key, ayn\u0131 iste\u011fin tekrar\u0131nda yeni bir operation olu\u015fturmak yerine mevcut olan\u0131 d\u00f6nd\u00fcrmeyi sa\u011flar. Baz\u0131 durumlarda i\u015f parametrelerine g\u00f6re de tekille\u015ftirme yap\u0131labilir. Ayn\u0131 kullan\u0131c\u0131 ayn\u0131 y\u0131l i\u00e7in zaten \u00e7al\u0131\u015fan bir rapor istediyse, yeni bir i\u015f ba\u015flatmak yerine mevcut i\u015fin adresi d\u00f6nd\u00fcr\u00fcl\u00fcr.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">\u0130ptal ve temizlik<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Uzun s\u00fcren bir i\u015fi iptal edebilmek kullan\u0131c\u0131 i\u00e7in de\u011ferlidir:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>POST \/api\/operations\/71:cancel<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">veya<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>DELETE \/api\/operations\/71<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Tamamlanm\u0131\u015f operation kay\u0131tlar\u0131 ve \u00fcrettikleri sonu\u00e7lar da sonsuza kadar saklanmamal\u0131. Belirli bir s\u00fcre sonra temizlenmeleri ve bunun dok\u00fcmantasyonda belirtilmesi gerekir.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Senkron API&#8217;ler basittir ve \u00e7o\u011fu durumda do\u011fru tercihtir.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Ama bir i\u015fin s\u00fcresi kontrol\u00fcn\u00fcz d\u0131\u015f\u0131ndaysa, client&#8217;\u0131 beklemeye zorlamak yerine ona takip edebilece\u011fi bir adres vermek, hem sistem hem kullan\u0131c\u0131 i\u00e7in daha dayan\u0131kl\u0131 bir s\u00f6zle\u015fmedir.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Rapor \u00fcretimi 3 dakika s\u00fcr\u00fcyorsa HTTP iste\u011fini 3 dakika a\u00e7\u0131k tutmak do\u011fru de\u011fil. 202 Accepted, operation kayna\u011f\u0131, polling ve callback ile asenkron API tasar\u0131m\u0131.<\/p>\n","protected":false},"author":1,"featured_media":135,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[9],"tags":[],"class_list":["post-136","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\/136","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=136"}],"version-history":[{"count":1,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/posts\/136\/revisions"}],"predecessor-version":[{"id":208,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/posts\/136\/revisions\/208"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/media\/135"}],"wp:attachment":[{"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/media?parent=136"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/categories?post=136"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/tags?post=136"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}