Bu sayfa, API istekleri yapmadan önce bilmeniz gereken ayrıntılar hakkında önemli bilgiler sağlar.
Güvenli API İstek İmzalama ve Idempotency Mekanizması
Genel Bakış
🧩 Bu API, HMAC tabanlı istek imzalama, zaman damgası, benzersiz istek tanımlama (nonce) ve idempotency anahtarları içeren sağlam bir güvenlik mekanizmasından yararlanır. Bu mekanizmalar; isteğin bütünlüğünü, kimlik doğrulamasını ve yeniden oynatılamamasını güvence altına alır, aynı zamanda yinelenen gönderimleri güvenle yönetir. 🛡️📘 Bu belgede her bir mekanizma, amaçları ve gerekli istemci mantığının nasıl uygulanacağı (örneğin Postman veya özel API istemcilerinde) açıklanmaktadır.
1. HMAC İmzası (X-Signature Başlığı)
Nedir?
🔑 Bir HMAC (Karma Tabanlı Mesaj Kimlik Doğrulama Kodu), paylaşılan bir sır ve istek verileri kullanılarak oluşturulan bir kriptografik imzadır. Talebin değiştirilememesini ve gönderenin kimliğinin doğrulanabilmesini sağlar.
Amacı
Bütünlük 🛡️: İsteğin herhangi bir kısmının (yöntem, URI, gövde, zaman damgası) değiştirilip değiştirilmediğini tespit eder.
Kimlik Doğrulama 🔐: İsteğin gizli anahtarı bilen güvenilir bir istemciden geldiğini doğrular.
Yeniden Oynatma Önleme ♻️: Bir zaman damgasına ve benzersiz değerlere bağlı olarak yeniden oynatma saldırılarını tespit edilebilir hale getirir.
Nasıl Kullanılır?
İstemci imzalamak için HTTP yöntemini, tam istek yolunu (sorgu dahil), milisaniye cinsinden geçerli zaman damgasını ve çözümlenmiş istek gövdesini birleştiren bir dize oluşturur 🧾:
⏱️ İsteğin oluşturulduğu andaki Unix zaman damgası (milisaniye cinsinden).
Amaç
Tekrar Oynatma Önleme 🛑: Sunucu geçerli istekler için katı zaman pencereleri uygulayabildiğinden, bir saldırganın daha önce geçerli olan bir isteği tekrar kullanmasını önler.
Nasıl Kullanılır?
İstemci, isteği göndermeden hemen önce zaman damgasını oluşturur ve bunu X-Timestamp başlığı olarak ekler ⌚.
Kullanılmazsa ne olur?
İstemci, http durumu 400 - Hatalı İstek olan bir hata mesajı alacaktır
{ "timestamp": "2025-04-14T16:58:10.414972912", "status": 400, "error": "Hatalı İstek", "message": "Eksik imza, zaman damgası veya nonce başlıkları", "path": "/auth/login"}
3. Nonce - Tek Seferlik (X-Nonce Başlığı)
Nedir?
🎲 Bir nonce, her istekte bulunan rastgele oluşturulmuş benzersiz bir tanımlayıcıdır (UUID v4).
Amaç
Yeniden Oynatma Önleme 🔁: Her isteği benzersiz bir şekilde tanımlayarak isteğin yeniden oynatılmasını daha da önler. Yöntem, URI ve gövde aynı olsa bile, nonce farklı olacaktır.
Nasıl Kullanılır?
İstemci her istek için yeni bir UUID v4 oluşturur ve bunu X-Nonce başlığı olarak ekler 🎯.
Kullanılmazsa ne olur?
İstemci, http durumu 400 - Hatalı İstek olan bir hata mesajı alacaktır
{ "timestamp": "2025-04-14T16:58:10.414972912", "status": 400, "error": "Hatalı İstek", "message": "Eksik imza, zaman damgası veya nonce başlıkları", "path": "/auth/login"}
Yeniden kullanılırsa ne olur?
İstemci http durumu 409 - Çakışma ile bir hata mesajı alacaktır
{ "timestamp": "2025-04-14T16:57:21.168927321", "status": 409, "error": "Çakışma", "message": "Yeniden oynatma saldırısı tespit edildi (nonce yeniden kullanıldı)", "path": "/endpoint/uri/here"}
🪪 Her istek için bir tekil tanımlayıcı (UUID v4), sunucunun yinelenen gönderimleri tanımasını ve güvenli bir şekilde göz ardı etmesini sağlar (örneğin, bir POST isteğinin yeniden denenmesi).
Amaç
Idempotency 🔂: Ağ hataları nedeniyle bir isteğin yeniden denenmesinin yinelenen kaynak oluşturma veya yan etkilere neden olmayacağını garanti eder.
Nasıl Kullanılır?
İstemci her işlem için yeni bir UUID v4 oluşturur ve bunu X-Idempotency-Key başlığı olarak gönderir 📮.
Kullanılmazsa ne olur?
İstemci, http durumu 400 - Hatalı İstek olan bir hata mesajı alacaktır
HMAC için kullanılan anahtaristemci kodunda veya belgelerinde asla paylaşılmamalı veya ifşa edilmemelidir 🔐.
Ortadaki adam saldırılarını önlemek için her zaman HTTPS kullanın 🌐.
Sunucular, X-Timestamp için izin verilen maksimum bir zaman eğriliği uygular ve belirli bir pencere içinde kullanılmış/tekrarlanmış X-Nonce veya X-Idempotency-Key değerlerini reddeder ⛔.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"iklim.co API Documentation","colors":{"primary":"#0066FF","light":"#cce0ff","dark":"#0552c8"},"logo":{"light":"https://mintcdn.com/iklimco/LsrMAyjk3mTN665c/logo/logo-primary.svg?fit=max\u0026auto=format\u0026n=LsrMAyjk3mTN665c\u0026q=85\u0026s=91b7252444bc2f59317716cac1669e20","dark":"https://mintcdn.com/iklimco/LsrMAyjk3mTN665c/logo/logo-white.svg?fit=max\u0026auto=format\u0026n=LsrMAyjk3mTN665c\u0026q=85\u0026s=9da1fec16b3ebbccaf5b1eff6175e5e7"},"favicon":"https://mintcdn.com/iklimco/_DMLSo5goc8NgvQb/favicon.ico?fit=max\u0026auto=format\u0026n=_DMLSo5goc8NgvQb\u0026q=85\u0026s=8d9e76919402195bfd85a160afcc075a","api":{"playground":{"display":"simple"}},"navbar":{"links":[{"href":"mailto:info@iklim.co","label":"Support"}],"primary":{"type":"button","label":"Production Status","href":"https://uptime.tarla.io/status/iklim-prod-ops"}},"footer":{"socials":{"x":"https://x.com/iklimco","github":"https://github.com/iklim-co","linkedin":"https://www.linkedin.com/company/iklim.co"}},"styling":{"eyebrows":"breadcrumbs","latex":false},"navigation":{"global":{"anchors":[]},"languages":[{"language":"en","href":"before-start/en/introduction"},{"language":"tr","href":"before-start/tr/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"iklimco","hasAudioNarration":false,"actualSubdomain":"iklimco","customDomains":["api-docs.iklim.co"],"gitSource":{"type":"github","owner":"iklim-co","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6afc31b844ba07be7352ee88","clientVersion":"0.0.4248","searchFilterCounts":[{"language":"en","tag":"Auth \u0026 User APIs","count":13},{"language":"tr","tag":"Kimlik Doğrulama \u0026 Kullanıcılar","count":13},{"language":"en","tag":"Region Alarm API","count":12},{"language":"en","tag":"Geo Alarm Registrations","count":12},{"language":"tr","tag":"Coğrafi Alan Alarm API","count":12},{"language":"tr","tag":"Coğrafi Alarm Kayıtları","count":12},{"language":"en","tag":"Forecast Alarm API","count":10},{"language":"en","tag":"Forecast Point Alarm Registrations","count":10},{"language":"tr","tag":"Tahnin Alarm API","count":10},{"language":"tr","tag":"Tahmin Nokta Alarm Kayıtları","count":10},{"language":"en","tag":"User Service","count":9},{"language":"tr","tag":"Kullanıcı Servisi","count":9},{"language":"en","tag":"Accounts API","count":8},{"language":"en","tag":"User Accounts Service","count":8},{"language":"tr","tag":"Hesaplar","count":8},{"language":"tr","tag":"Kullanıcı Hesapları Servisi","count":8},{"language":"en","tag":"Precipitation API","count":7},{"language":"en","tag":"Point Alarm API","count":6},{"language":"tr","tag":"Nokta Alarm API","count":6},{"language":"tr","tag":"Nokta Alarmları","count":6}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"html.dark[data-current-path^=\"/api-reference/\"] #content-area header .prose pre.shiki{background-color:var(--shiki-dark-bg, #0b0c0e)!important;color:var(--shiki-dark, #d4d4d4)!important}"}]}
{"page":{"pagePath":"before-start/tr/introduction","slug":"/before-start/tr/introduction","pageMetadata":{"title":"API Güvenliği","icon":"shield-halved","description":"Bu sayfa, API istekleri yapmadan önce bilmeniz gereken ayrıntılar hakkında önemli bilgiler sağlar.","href":"/before-start/tr/introduction"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Bu sayfa, API istekleri yapmadan önce bilmeniz gereken ayrıntılar hakkında önemli bilgiler sağlar.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,em:`em`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Card,CodeBlock,Heading,Icon,Table,Warning}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Icon)_missingMdxReference(`Icon`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`1`,id:`güvenli-api-i̇stek-i̇mzalama-ve-idempotency-mekanizması`,children:`Güvenli API İstek İmzalama ve Idempotency Mekanizması`}),`\n`,_jsx(Heading,{level:`2`,id:`genel-bakış`,children:`Genel Bakış`}),`\n`,_jsxs(_components.p,{children:[`🧩 Bu API, `,_jsx(_components.strong,{children:`HMAC tabanlı istek imzalama, zaman damgası, benzersiz istek tanımlama (nonce)`}),` ve `,_jsx(_components.strong,{children:`idempotency anahtarları`}),` içeren sağlam bir güvenlik mekanizmasından yararlanır. Bu mekanizmalar; isteğin bütünlüğünü, kimlik doğrulamasını ve yeniden oynatılamamasını güvence altına alır, aynı zamanda yinelenen gönderimleri güvenle yönetir. 🛡️`]}),`\n`,_jsx(_components.p,{children:`📘 Bu belgede her bir mekanizma, amaçları ve gerekli istemci mantığının nasıl uygulanacağı (örneğin Postman veya özel API istemcilerinde) açıklanmaktadır.`}),`\n`,_jsxs(Heading,{level:`2`,id:`1-hmac-i̇mzası-x-signature-başlığı`,children:[`1. HMAC İmzası (`,_jsx(_components.code,{children:`X-Signature`}),` Başlığı)`]}),`\n`,_jsx(Heading,{level:`3`,id:`nedir`,children:`Nedir?`}),`\n`,_jsxs(_components.p,{children:[`🔑 Bir `,_jsx(_components.strong,{children:`HMAC (Karma Tabanlı Mesaj Kimlik Doğrulama Kodu)`}),`, paylaşılan bir sır ve istek verileri kullanılarak oluşturulan bir kriptografik imzadır. Talebin değiştirilememesini ve gönderenin kimliğinin doğrulanabilmesini sağlar.`]}),`\n`,_jsx(Heading,{level:`3`,id:`amacı`,children:`Amacı`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Bütünlük 🛡️:`}),` İsteğin herhangi bir kısmının (yöntem, URI, gövde, zaman damgası) değiştirilip değiştirilmediğini tespit eder.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Kimlik Doğrulama 🔐:`}),` İsteğin gizli anahtarı bilen güvenilir bir istemciden geldiğini doğrular.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Yeniden Oynatma Önleme ♻️:`}),` Bir zaman damgasına ve benzersiz değerlere bağlı olarak yeniden oynatma saldırılarını tespit edilebilir hale getirir.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`nasıl-kullanılır`,children:`Nasıl Kullanılır?`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`İstemci imzalamak için HTTP yöntemini, tam istek yolunu (sorgu dahil), `,_jsx(_components.em,{children:_jsx(_components.strong,{children:`milisaniye cinsinden geçerli zaman damgasını`})}),` ve çözümlenmiş istek gövdesini birleştiren bir dize oluşturur 🧾:`]}),`\n`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`ini`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`ini`,children:_jsxs(_components.code,{language:`ini`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`dataToSign`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` = HTTP_METHOD + `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"|\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` + PATH_WITH_QUERY + `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"|\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` + TIMESTAMP + `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"|\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` + BODY`})]}),`\n`]})})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`İstemci, paylaşılan anahtarı (güvenli bir kasada tutulur, `,_jsx(_components.strong,{children:`asla ifşa edilmez`}),`) kullanarak HMAC SHA256 imzasını oluşturur 🔒:`]}),`\n`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`ini`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`ini`,children:_jsxs(_components.code,{language:`ini`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`X-Signature`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` = HMAC_SHA256(secret, dataToSign)`})]}),`\n`]})})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Bu imza `,_jsx(_components.code,{children:`X-Signature`}),` istek başlığında gönderilir 🚀.`]}),`\n`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`⚠️ İlk API çağrınızı yapmadan önce lütfen bizden `,_jsx(_components.strong,{children:`HMAC Anahtarını`}),` talep edin.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`kullanılmazsa-ne-olur`,children:`Kullanılmazsa ne olur?`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`İstemci http durumu `,_jsx(_components.code,{children:`400 - Hatalı İstek`}),` ile bir hata mesajı alacaktır`]}),`\n`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"timestamp\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2025-04-14T16:58:10.414972912\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`400`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Hatalı İstek\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Eksik imza, zaman damgası veya nonce başlıkları\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"path\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"/auth/login\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`i̇mza-geçerli-değilse-ne-olur`,children:`İmza geçerli değilse ne olur?`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`İstemci, http durumu `,_jsx(_components.code,{children:`401 - Yetkisiz`}),` olan bir hata mesajı alacaktır.`]}),`\n`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"timestamp\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2025-04-14T16:57:50.083970026\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`401`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Yetkisiz\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Geçersiz istek imzası\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"path\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"/auth/login\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(Heading,{level:`2`,id:`2-zaman-damgası-x-timestamp-başlığı`,children:[`2. Zaman Damgası (`,_jsx(_components.code,{children:`X-Timestamp`}),` Başlığı)`]}),`\n`,_jsx(Heading,{level:`3`,id:`nedir-2`,children:`Nedir?`}),`\n`,_jsx(_components.p,{children:`⏱️ İsteğin oluşturulduğu andaki Unix zaman damgası (milisaniye cinsinden).`}),`\n`,_jsx(Heading,{level:`3`,id:`amaç`,children:`Amaç`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Tekrar Oynatma Önleme 🛑:`}),` Sunucu geçerli istekler için katı zaman pencereleri uygulayabildiğinden, bir saldırganın daha önce geçerli olan bir isteği tekrar kullanmasını önler.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`nasıl-kullanılır-2`,children:`Nasıl Kullanılır?`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`İstemci, isteği göndermeden hemen önce zaman damgasını oluşturur ve bunu `,_jsx(_components.code,{children:`X-Timestamp`}),` başlığı olarak ekler ⌚.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`kullanılmazsa-ne-olur-2`,children:`Kullanılmazsa ne olur?`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`İstemci, http durumu `,_jsx(_components.code,{children:`400 - Hatalı İstek`}),` olan bir hata mesajı alacaktır`]}),`\n`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"timestamp\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2025-04-14T16:58:10.414972912\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`400`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Hatalı İstek\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Eksik imza, zaman damgası veya nonce başlıkları\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"path\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"/auth/login\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(Heading,{level:`2`,id:`3-nonce-tek-seferlik-x-nonce-başlığı`,children:[`3. Nonce - Tek Seferlik (`,_jsx(_components.code,{children:`X-Nonce`}),` Başlığı)`]}),`\n`,_jsx(Heading,{level:`3`,id:`nedir-3`,children:`Nedir?`}),`\n`,_jsxs(_components.p,{children:[`🎲 Bir `,_jsx(_components.strong,{children:`nonce`}),`, her istekte bulunan rastgele oluşturulmuş benzersiz bir tanımlayıcıdır (UUID v4).`]}),`\n`,_jsx(Heading,{level:`3`,id:`amaç-2`,children:`Amaç`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Yeniden Oynatma Önleme 🔁:`}),` Her isteği benzersiz bir şekilde tanımlayarak isteğin yeniden oynatılmasını daha da önler. Yöntem, URI ve gövde aynı olsa bile, nonce farklı olacaktır.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`nasıl-kullanılır-3`,children:`Nasıl Kullanılır?`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`İstemci her istek için yeni bir UUID v4 oluşturur ve bunu `,_jsx(_components.code,{children:`X-Nonce`}),` başlığı olarak ekler 🎯.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`kullanılmazsa-ne-olur-3`,children:`Kullanılmazsa ne olur?`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`İstemci, http durumu `,_jsx(_components.code,{children:`400 - Hatalı İstek`}),` olan bir hata mesajı alacaktır`]}),`\n`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"timestamp\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2025-04-14T16:58:10.414972912\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`400`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Hatalı İstek\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Eksik imza, zaman damgası veya nonce başlıkları\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"path\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"/auth/login\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`yeniden-kullanılırsa-ne-olur`,children:`Yeniden kullanılırsa ne olur?`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`İstemci http durumu `,_jsx(_components.code,{children:`409 - Çakışma`}),` ile bir hata mesajı alacaktır`]}),`\n`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"timestamp\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2025-04-14T16:57:21.168927321\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`409`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Çakışma\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Yeniden oynatma saldırısı tespit edildi (nonce yeniden kullanıldı)\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"path\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"/endpoint/uri/here\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(Heading,{level:`2`,id:`4-idempotency-anahtarı-x-idempotency-key-başlığı`,children:[`4. Idempotency Anahtarı (`,_jsx(_components.code,{children:`X-Idempotency-Key`}),` Başlığı)`]}),`\n`,_jsx(Heading,{level:`3`,id:`nedir-4`,children:`Nedir?`}),`\n`,_jsxs(_components.p,{children:[`🪪 Her istek için bir `,_jsx(_components.strong,{children:`tekil tanımlayıcı`}),` (UUID v4), sunucunun yinelenen gönderimleri tanımasını ve güvenli bir şekilde göz ardı etmesini sağlar (örneğin, bir POST isteğinin yeniden denenmesi).`]}),`\n`,_jsx(Heading,{level:`3`,id:`amaç-3`,children:`Amaç`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Idempotency 🔂:`}),` Ağ hataları nedeniyle bir isteğin yeniden denenmesinin yinelenen kaynak oluşturma veya yan etkilere neden olmayacağını garanti eder.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`nasıl-kullanılır-4`,children:`Nasıl Kullanılır?`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`İstemci her işlem için yeni bir UUID v4 oluşturur ve bunu `,_jsx(_components.code,{children:`X-Idempotency-Key`}),` başlığı olarak gönderir 📮.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`kullanılmazsa-ne-olur-4`,children:`Kullanılmazsa ne olur?`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`İstemci, http durumu `,_jsx(_components.code,{children:`400 - Hatalı İstek`}),` olan bir hata mesajı alacaktır`]}),`\n`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"timestamp\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2025-04-14T16:26:54.203118461\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`400`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Hatalı İstek\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Eksik X-Idempotency-Key başlığı\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"path\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"/endpoint/uri/here\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`yeniden-kullanılırsa-ne-olur-2`,children:`Yeniden kullanılırsa ne olur?`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`İstemci http durumu `,_jsx(_components.code,{children:`409 - Çakışma`}),` ile bir hata mesajı alacaktır`]}),`\n`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"timestamp\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2025-04-14T16:56:28.671809875\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`409`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Çakışma\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Yinelenen istek algılandı (X-Idempotency-Key)\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"path\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"/endpoint/uri/here\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Card,{title:`Güvenlikle İlgili Hususlar`,icon:`shield-halved`,children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`HMAC için kullanılan `,_jsx(_components.code,{children:`anahtar`}),` `,_jsx(_components.strong,{children:`istemci kodunda veya belgelerinde asla paylaşılmamalı veya ifşa edilmemelidir`}),` 🔐.`]}),`\n`,_jsx(_components.li,{children:`Ortadaki adam saldırılarını önlemek için her zaman HTTPS kullanın 🌐.`}),`\n`,_jsxs(_components.li,{children:[`Sunucular, `,_jsx(_components.code,{children:`X-Timestamp`}),` için izin verilen maksimum bir zaman eğriliği uygular ve belirli bir pencere içinde kullanılmış/tekrarlanmış `,_jsx(_components.code,{children:`X-Nonce`}),` veya `,_jsx(_components.code,{children:`X-Idempotency-Key`}),` değerlerini reddeder ⛔.`]}),`\n`]})}),`\n`,_jsx(Card,{title:`Örnek Başlıklar`,icon:`table-list`,children:_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`ini`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`ini`,children:_jsxs(_components.code,{language:`ini`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`X-Signature: 75c759570bbb5dfd40136cffd3dbaa51b28d4620e51359161686790adcc53bea`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`X-Timestamp: 1752751106704`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`X-Nonce: 684a0dca-bd6a-4056-a449-2567f9847f9c`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`X-Idempotency-Key: 777edc03-ad49-4c17-be6b-9baf05a1b9e0`})}),`\n`]})})})}),`\n`,_jsx(Heading,{level:`3`,id:`özet-tablo-`,children:`Özet Tablo 📊`}),`\n`,_jsx(Icon,{icon:`table-cells`,size:32}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Başlık`}),_jsx(_components.th,{children:`Değer/Format`}),_jsx(_components.th,{children:`Amaç`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`X-Signature`}),_jsx(_components.td,{children:`Hexadecimal string`}),_jsx(_components.td,{children:`Orijinallik/bütünlük talebi`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`X-Timestamp`}),_jsx(_components.td,{children:`Milliseconds since epoch`}),_jsx(_components.td,{children:`Yeniden oynatmayı önler`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`X-Nonce`}),_jsx(_components.td,{children:`UUID v4`}),_jsx(_components.td,{children:`Teklik/tekrarı önleme`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`X-Idempotency-Key`}),_jsx(_components.td,{children:`UUID v4`}),_jsx(_components.td,{children:`Yeniden denemeler için Idempotency`})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"API Güvenliği","icon":"shield-halved","description":"Bu sayfa, API istekleri yapmadan önce bilmeniz gereken ayrıntılar hakkında önemli bilgiler sağlar.","href":"/before-start/tr/introduction"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Güvenli API İstek İmzalama ve Idempotency Mekanizması","slug":"güvenli-api-i̇stek-i̇mzalama-ve-idempotency-mekanizması","depth":1,"children":[]},{"title":"Genel Bakış","slug":"genel-bakış","depth":2,"children":[]},{"title":"1. HMAC İmzası (X-Signature Başlığı)","slug":"1-hmac-i̇mzası-x-signature-başlığı","depth":2,"children":[{"title":"Nedir?","slug":"nedir","depth":3,"children":[]},{"title":"Amacı","slug":"amacı","depth":3,"children":[]},{"title":"Nasıl Kullanılır?","slug":"nasıl-kullanılır","depth":3,"children":[]},{"title":"Kullanılmazsa ne olur?","slug":"kullanılmazsa-ne-olur","depth":3,"children":[]},{"title":"İmza geçerli değilse ne olur?","slug":"i̇mza-geçerli-değilse-ne-olur","depth":3,"children":[]}]},{"title":"2. Zaman Damgası (X-Timestamp Başlığı)","slug":"2-zaman-damgası-x-timestamp-başlığı","depth":2,"children":[{"title":"Nedir?","slug":"nedir-2","depth":3,"children":[]},{"title":"Amaç","slug":"amaç","depth":3,"children":[]},{"title":"Nasıl Kullanılır?","slug":"nasıl-kullanılır-2","depth":3,"children":[]},{"title":"Kullanılmazsa ne olur?","slug":"kullanılmazsa-ne-olur-2","depth":3,"children":[]}]},{"title":"3. Nonce - Tek Seferlik (X-Nonce Başlığı)","slug":"3-nonce-tek-seferlik-x-nonce-başlığı","depth":2,"children":[{"title":"Nedir?","slug":"nedir-3","depth":3,"children":[]},{"title":"Amaç","slug":"amaç-2","depth":3,"children":[]},{"title":"Nasıl Kullanılır?","slug":"nasıl-kullanılır-3","depth":3,"children":[]},{"title":"Kullanılmazsa ne olur?","slug":"kullanılmazsa-ne-olur-3","depth":3,"children":[]},{"title":"Yeniden kullanılırsa ne olur?","slug":"yeniden-kullanılırsa-ne-olur","depth":3,"children":[]}]},{"title":"4. Idempotency Anahtarı (X-Idempotency-Key Başlığı)","slug":"4-idempotency-anahtarı-x-idempotency-key-başlığı","depth":2,"children":[{"title":"Nedir?","slug":"nedir-4","depth":3,"children":[]},{"title":"Amaç","slug":"amaç-3","depth":3,"children":[]},{"title":"Nasıl Kullanılır?","slug":"nasıl-kullanılır-4","depth":3,"children":[]},{"title":"Kullanılmazsa ne olur?","slug":"kullanılmazsa-ne-olur-4","depth":3,"children":[]},{"title":"Yeniden kullanılırsa ne olur?","slug":"yeniden-kullanılırsa-ne-olur-2","depth":3,"children":[]},{"title":"Özet Tablo 📊","slug":"özet-tablo-","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":[],"subdomain":"iklimco","siteName":"iklim.co API Documentation","title":"API Güvenliği - iklim.co API Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/before-start/en/introduction","matchLevel":1},"tr":{"href":"/before-start/tr/introduction","matchLevel":0}}},"lastModified":"2026-11-17T08:21:12.074Z","originalFileLocation":"before-start/tr/introduction.mdx","locale":"tr"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Bu sayfa, API istekleri yapmadan önce bilmeniz gereken ayrıntılar hakkında önemli bilgiler sağlar.\">\u003cmeta data-mint-head name=\"application-name\" content=\"iklim.co API Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/iklimco/s7XYvTG33QJSx4wx/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/iklimco/s7XYvTG33QJSx4wx/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/iklimco/s7XYvTG33QJSx4wx/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/iklimco/s7XYvTG33QJSx4wx/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/iklimco/s7XYvTG33QJSx4wx/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/iklimco/s7XYvTG33QJSx4wx/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/iklimco/s7XYvTG33QJSx4wx/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/iklimco/s7XYvTG33QJSx4wx/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/iklimco/s7XYvTG33QJSx4wx/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"API Güvenliği - iklim.co API Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Bu sayfa, API istekleri yapmadan önce bilmeniz gereken ayrıntılar hakkında önemli bilgiler sağlar.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"iklim.co API Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://api-docs.iklim.co/before-start/tr/introduction\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://iklimco.mintlify.site/_mintlify/api/og/v2?division=Ba%C5%9Flamadan+%C3%96nce\u0026amp;title=API+G%C3%BCvenli%C4%9Fi\u0026amp;description=Bu+sayfa%2C+API+istekleri+yapmadan+%C3%B6nce+bilmeniz+gereken+ayr%C4%B1nt%C4%B1lar+hakk%C4%B1nda+%C3%B6nemli+bilgiler+sa%C4%9Flar.\u0026amp;theme=521c519ba2c0d6d31503366b\u0026amp;signature=0d31a749584674c46639a5f440ae17c1449d83a1afd3ec82733d06ffd2b96cd6\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"API Güvenliği - iklim.co API Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Bu sayfa, API istekleri yapmadan önce bilmeniz gereken ayrıntılar hakkında önemli bilgiler sağlar.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://iklimco.mintlify.site/_mintlify/api/og/v2?division=Ba%C5%9Flamadan+%C3%96nce\u0026amp;title=API+G%C3%BCvenli%C4%9Fi\u0026amp;description=Bu+sayfa%2C+API+istekleri+yapmadan+%C3%B6nce+bilmeniz+gereken+ayr%C4%B1nt%C4%B1lar+hakk%C4%B1nda+%C3%B6nemli+bilgiler+sa%C4%9Flar.\u0026amp;theme=521c519ba2c0d6d31503366b\u0026amp;signature=0d31a749584674c46639a5f440ae17c1449d83a1afd3ec82733d06ffd2b96cd6\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/iklimco/s7XYvTG33QJSx4wx/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"iklim.co API Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0066FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://api-docs.iklim.co/before-start/tr/introduction\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/before-start/tr/introduction.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"tr\" href=\"https://api-docs.iklim.co/before-start/tr/introduction\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://api-docs.iklim.co/before-start/en/introduction\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://api-docs.iklim.co/before-start/en/introduction\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://api-docs.iklim.co/#organization\",\"name\":\"iklim.co API Documentation\",\"url\":\"https://api-docs.iklim.co\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/iklimco/LsrMAyjk3mTN665c/logo/logo-primary.svg?fit=max\u0026auto=format\u0026n=LsrMAyjk3mTN665c\u0026q=85\u0026s=91b7252444bc2f59317716cac1669e20\"}},{\"@type\":\"WebSite\",\"@id\":\"https://api-docs.iklim.co#website\",\"name\":\"iklim.co API Documentation\",\"url\":\"https://api-docs.iklim.co\",\"publisher\":{\"@id\":\"https://api-docs.iklim.co/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://api-docs.iklim.co/before-start/tr/introduction#webpage\",\"url\":\"https://api-docs.iklim.co/before-start/tr/introduction\",\"name\":\"API Güvenliği\",\"description\":\"Bu sayfa, API istekleri yapmadan önce bilmeniz gereken ayrıntılar hakkında önemli bilgiler sağlar.\",\"dateModified\":\"2026-11-17T08:21:12.074Z\",\"isPartOf\":{\"@id\":\"https://api-docs.iklim.co#website\"},\"breadcrumb\":{\"@id\":\"https://api-docs.iklim.co/before-start/tr/introduction#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://api-docs.iklim.co/before-start/tr/introduction#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"iklim.co API Documentation\",\"item\":\"https://api-docs.iklim.co\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API Güvenliği\",\"item\":\"https://api-docs.iklim.co/before-start/tr/introduction\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://api-docs.iklim.co/before-start/tr/introduction#article\",\"headline\":\"API Güvenliği\",\"name\":\"API Güvenliği\",\"description\":\"Bu sayfa, API istekleri yapmadan önce bilmeniz gereken ayrıntılar hakkında önemli bilgiler sağlar.\",\"url\":\"https://api-docs.iklim.co/before-start/tr/introduction\",\"mainEntityOfPage\":{\"@id\":\"https://api-docs.iklim.co/before-start/tr/introduction#webpage\"},\"dateModified\":\"2026-11-17T08:21:12.074Z\",\"publisher\":{\"@id\":\"https://api-docs.iklim.co/#organization\"},\"isPartOf\":{\"@id\":\"https://api-docs.iklim.co#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"iklim.co API Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"iklim.co API Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/before-start/tr/introduction.md","siteName":"iklim.co API Documentation","nav":{"global":{"anchors":[]},"languages":[{"language":"en","pages":[{"title":"en","href":"/before-start/en/introduction"}]},{"language":"tr","groups":[{"group":"Başlamadan Önce","icon":"book","pages":[{"title":"API Güvenliği","icon":"shield-halved","href":"/before-start/tr/introduction"},{"title":"Kimlik Doğrulama","icon":"fingerprint","description":"Kimlik doğrulama, kullanıcıların kimliğini doğrulayarak API Hizmetlerinin gizliliğini garanti eder. Kimlik doğrulama, kullanıcıların iklim.co API Hizmetlerine erişmeden önce oturum açmasını gerektirir. Bu kılavuz, mevcut her el sıkışma yöntemi için kurulumu kapsar.","href":"/before-start/tr/authentication"},{"title":"Kullanıcı Seçenekleri","icon":"circle-user","href":"/before-start/tr/final-briefing"}]},{"group":"Webhook Alarmları","icon":"comment-dots","pages":[{"title":"Webhook Uç Nokta Kılavuzu","icon":"server","href":"/webhook-messages/tr/webhook-endpoint-guide"},{"title":"Yıldırım/Şimşek Bildirimi","icon":"cloud-bolt","href":"/webhook-messages/tr/lightning"},{"title":"Fırtına Bildirimi","icon":"hurricane","href":"/webhook-messages/tr/thunderstorm"},{"title":"Yağış Bildirimi","icon":"cloud-rain","href":"/webhook-messages/tr/precipitation"},{"title":"Hava Tahmin Bildirimi","icon":"cloud-sun","href":"/webhook-messages/tr/forecast"}]},{"group":"MCP Sunucusu","icon":"robot","tag":"YENİ","pages":[{"title":"MCP Sunucusu","icon":"robot","href":"/pages/tr/mcp-server"}]},{"group":"Kimlik Doğrulama \u0026 Kullanıcılar","icon":"user-lock","pages":[{"group":"Kullanıcı Servisi","pages":[{"title":"Şifre Sıfırlama İşlemi","deprecated":null,"version":null,"openapi":"/open-api/tr/auth-version-1.json post /v1/users/password-reset","href":"/api-reference/kullanıcı-servisi/şifre-sıfırlama-i̇şlemi"},{"title":"Şifre Sıfırlama İsteği Yapılan İşlem","deprecated":null,"version":null,"openapi":"/open-api/tr/auth-version-1.json post /v1/users/password-reset-request","href":"/api-reference/kullanıcı-servisi/şifre-sıfırlama-i̇steği-yapılan-i̇şlem"},{"title":"Sayfalanabilir Kullanıcı Listeleme İşlemi","deprecated":null,"version":null,"openapi":"/open-api/tr/auth-version-1.json post /v1/users/page","href":"/api-reference/kullanıcı-servisi/sayfalanabilir-kullanıcı-listeleme-i̇şlemi"},{"title":"Yeni Kullanıcı Oluşturma İşlemi","deprecated":null,"version":null,"openapi":"/open-api/tr/auth-version-1.json post /v1/users/create","href":"/api-reference/kullanıcı-servisi/yeni-kullanıcı-oluşturma-i̇şlemi"},{"title":"Şifre Değiştirme İşlemi","deprecated":null,"version":null,"openapi":"/open-api/tr/auth-version-1.json post /v1/users/change-password","href":"/api-reference/kullanıcı-servisi/şifre-değiştirme-i̇şlemi"},{"title":"Kullanıcı Güncelleme İşlemi","deprecated":null,"version":null,"openapi":"/open-api/tr/auth-version-1.json patch /v1/users/update","href":"/api-reference/kullanıcı-servisi/kullanıcı-güncelleme-i̇şlemi"},{"title":"Kullanıcı Getir İşlemi","deprecated":null,"version":null,"openapi":"/open-api/tr/auth-version-1.json get /v1/users/{userId}","href":"/api-reference/kullanıcı-servisi/kullanıcı-getir-i̇şlemi"},{"title":"Kullanıcı Engelini Kaldırma İşlemi","deprecated":null,"version":null,"openapi":"/open-api/tr/auth-version-1.json get /v1/users/unblock/{userId}","href":"/api-reference/kullanıcı-servisi/kullanıcı-engelini-kaldırma-i̇şlemi"},{"title":"Kendi Kullanıcı Bilgilerini Getir İşlemi","deprecated":null,"version":null,"openapi":"/open-api/tr/auth-version-1.json get /v1/users/me","href":"/api-reference/kullanıcı-servisi/kendi-kullanıcı-bilgilerini-getir-i̇şlemi"}]},{"group":"Yetklilendirme Servisi","pages":[{"title":"Yeni Kullanıcı Kaydı","deprecated":null,"version":null,"openapi":"/open-api/tr/auth-version-1.json post /v1/auth/register","href":"/api-reference/yetklilendirme-servisi/yeni-kullanıcı-kaydı"},{"title":"Yetki Belirteci Yenileme İşlemi","deprecated":null,"version":null,"openapi":"/open-api/tr/auth-version-1.json post /v1/auth/refresh","href":"/api-reference/yetklilendirme-servisi/yetki-belirteci-yenileme-i̇şlemi"},{"title":"Çıkış İşlemi","deprecated":null,"version":null,"openapi":"/open-api/tr/auth-version-1.json post /v1/auth/logout","href":"/api-reference/yetklilendirme-servisi/çıkış-i̇şlemi"},{"title":"Giriş İşlemi","deprecated":null,"version":null,"openapi":"/open-api/tr/auth-version-1.json post /v1/auth/login","href":"/api-reference/yetklilendirme-servisi/giriş-i̇şlemi"}]}]},{"group":"Hesaplar","icon":"id-card","pages":[{"group":"Kullanıcı Hesapları Servisi","pages":[{"title":"Abonelik Planını Güncelle","deprecated":null,"version":null,"openapi":"/open-api/tr/accounts-version-1.json post /v1/accounts/update-subscription","href":"/api-reference/kullanıcı-hesapları-servisi/abonelik-planını-güncelle"},{"title":"Telefon Aktivasyon Talebi","deprecated":null,"version":null,"openapi":"/open-api/tr/accounts-version-1.json post /v1/accounts/phone-number-activation-request","href":"/api-reference/kullanıcı-hesapları-servisi/telefon-aktivasyon-talebi"},{"title":"Hesap Oluştur","deprecated":null,"version":null,"openapi":"/open-api/tr/accounts-version-1.json post /v1/accounts/create","href":"/api-reference/kullanıcı-hesapları-servisi/hesap-oluştur"},{"title":"Hesap Aktivasyonu Talebi","deprecated":null,"version":null,"openapi":"/open-api/tr/accounts-version-1.json post /v1/accounts/account-activation-request","href":"/api-reference/kullanıcı-hesapları-servisi/hesap-aktivasyonu-talebi"},{"title":"Hesap Güncelle","deprecated":null,"version":null,"openapi":"/open-api/tr/accounts-version-1.json patch /v1/accounts/update","href":"/api-reference/kullanıcı-hesapları-servisi/hesap-güncelle"},{"title":"Hesap Bilgilerini Getir","deprecated":null,"version":null,"openapi":"/open-api/tr/accounts-version-1.json get /v1/accounts/{userId}","href":"/api-reference/kullanıcı-hesapları-servisi/hesap-bilgilerini-getir"},{"title":"Telefon Numarasını Aktive Et","deprecated":null,"version":null,"openapi":"/open-api/tr/accounts-version-1.json get /v1/accounts/activate-phone-number","href":"/api-reference/kullanıcı-hesapları-servisi/telefon-numarasını-aktive-et"},{"title":"Hesabı Aktive Et","deprecated":null,"version":null,"openapi":"/open-api/tr/accounts-version-1.json get /v1/accounts/activate-account","href":"/api-reference/kullanıcı-hesapları-servisi/hesabı-aktive-et"}]}]},{"group":"Yıldırım/Şimşek","icon":"cloud-bolt","pages":[{"group":"Yıldırım/Şimşek Hizmeti","pages":[{"title":"İçinde Sorgusu","deprecated":null,"version":null,"openapi":"/open-api/tr/lightnings_version-1.json post /v1/lightnings/within","href":"/api-reference/yıldırımşimşek-hizmeti/i̇çinde-sorgusu"},{"title":"Sayfa Sorgusu","deprecated":null,"version":null,"openapi":"/open-api/tr/lightnings_version-1.json post /v1/lightnings/page","href":"/api-reference/yıldırımşimşek-hizmeti/sayfa-sorgusu"}]}]},{"group":"Fırtına","icon":"hurricane","pages":[{"group":"Fırtına Hizmeti","pages":[{"title":"Fırtına Listesi (Yarıçap İçinde)","deprecated":null,"version":null,"openapi":"/open-api/tr/thunderstorms_version-1.json post /v1/thunderstorms/within","href":"/api-reference/fırtına-hizmeti/fırtına-listesi-yarıçap-i̇çinde"},{"title":"Fırtına Listesi (Sayfalı)","deprecated":null,"version":null,"openapi":"/open-api/tr/thunderstorms_version-1.json post /v1/thunderstorms/page","href":"/api-reference/fırtına-hizmeti/fırtına-listesi-sayfalı"},{"title":"Fırtına Detayı Getir","deprecated":null,"version":null,"openapi":"/open-api/tr/thunderstorms_version-1.json post /v1/thunderstorms/get","href":"/api-reference/fırtına-hizmeti/fırtına-detayı-getir"}]}]},{"group":"Yağış","icon":"cloud-rain","tag":"GÜNCELLENDİ","pages":[{"title":"Yağış Geometrisi","icon":"draw-polygon","tag":"YENİ","href":"/pages/tr/precipitation-geometry"},{"group":"Yağış Hizmeti","pages":[{"title":"İçinde Sorgusu","deprecated":null,"version":null,"openapi":"/open-api/tr/precipitations_version-1.json post /v1/precipitations/within","href":"/api-reference/yağış-hizmeti/i̇çinde-sorgusu"},{"title":"Sayfalama Sorgusu","deprecated":null,"version":null,"openapi":"/open-api/tr/precipitations_version-1.json post /v1/precipitations/page","href":"/api-reference/yağış-hizmeti/sayfalama-sorgusu"},{"title":"Geometri Sorgusu","deprecated":null,"version":null,"openapi":"/open-api/tr/precipitations_version-1.json post /v1/precipitations/geometry","href":"/api-reference/yağış-hizmeti/geometri-sorgusu"}]}]},{"group":"Tahminler","icon":"cloud-sun","tag":"","pages":[{"group":"Hava Tahmini Servisi","pages":[{"title":"Saatlik Tahmin İşlemi","deprecated":null,"version":null,"openapi":"/open-api/tr/forecasts_version-1.json post /v1/forecasts/hourly","href":"/api-reference/hava-tahmini-servisi/saatlik-tahmin-i̇şlemi"},{"title":"Günlük Tahmin İşlemi","deprecated":null,"version":null,"openapi":"/open-api/tr/forecasts_version-1.json post /v1/forecasts/daily","href":"/api-reference/hava-tahmini-servisi/günlük-tahmin-i̇şlemi"},{"title":"Güncel Tahmin İşlemi","deprecated":null,"version":null,"openapi":"/open-api/tr/forecasts_version-1.json post /v1/forecasts/current","href":"/api-reference/hava-tahmini-servisi/güncel-tahmin-i̇şlemi"}]},{"group":"Hava Durumu Simgeleri","pages":[{"title":"Hava Durumu Simgesi Al","deprecated":null,"version":null,"openapi":"/open-api/tr/forecasts_version-1.json get /v1/weather-icons/{dayOrNight}/{iconName}","href":"/api-reference/hava-durumu-simgeleri/hava-durumu-simgesi-al"}]}]},{"group":"Nokta Alarm API","icon":"map-pin","tag":"","pages":[{"group":"Nokta Alarmları","pages":[{"title":"Nokta alarm kaydı oluştur","deprecated":null,"version":null,"openapi":"/open-api/tr/point-alarm_version-1.json post /v1/alarms/points/register","href":"/api-reference/nokta-alarmları/nokta-alarm-kaydı-oluştur"},{"title":"Kayıtları sayfalı listele","deprecated":null,"version":null,"openapi":"/open-api/tr/point-alarm_version-1.json post /v1/alarms/points/page","href":"/api-reference/nokta-alarmları/kayıtları-sayfalı-listele"},{"title":"Nokta alarm kaydını güncelle","deprecated":null,"version":null,"openapi":"/open-api/tr/point-alarm_version-1.json patch /v1/alarms/points/update","href":"/api-reference/nokta-alarmları/nokta-alarm-kaydını-güncelle"},{"title":"recipientId ile kayıtları listele","deprecated":null,"version":null,"openapi":"/open-api/tr/point-alarm_version-1.json get /v1/alarms/points/get-by-recipient-id/{recipientId}","href":"/api-reference/nokta-alarmları/recipientid-ile-kayıtları-listele"},{"title":"Kayıt ID ile getir","deprecated":null,"version":null,"openapi":"/open-api/tr/point-alarm_version-1.json get /v1/alarms/points/get-by-id/{registrationId}","href":"/api-reference/nokta-alarmları/kayıt-id-ile-getir"},{"title":"Nokta alarm kaydını sil (kaydını kaldır)","deprecated":null,"version":null,"openapi":"/open-api/tr/point-alarm_version-1.json delete /v1/alarms/points/unregister/{registrationId}","href":"/api-reference/nokta-alarmları/nokta-alarm-kaydını-sil-kaydını-kaldır"}]}]},{"group":"Coğrafi Alan Alarm API","icon":"vector-square","tag":"","pages":[{"group":"Coğrafi Alarm Kayıtları","pages":[{"title":"Alarm kaydı oluştur","deprecated":null,"version":null,"openapi":"/open-api/tr/geo-alarm_version-1.json post /v1/alarms/geometries/register","href":"/api-reference/coğrafi-alarm-kayıtları/alarm-kaydı-oluştur"},{"title":"Kayıtları sayfalı listele","deprecated":null,"version":null,"openapi":"/open-api/tr/geo-alarm_version-1.json post /v1/alarms/geometries/page","href":"/api-reference/coğrafi-alarm-kayıtları/kayıtları-sayfalı-listele"},{"title":"Alarm kaydını güncelle","deprecated":null,"version":null,"openapi":"/open-api/tr/geo-alarm_version-1.json patch /v1/alarms/geometries/update","href":"/api-reference/coğrafi-alarm-kayıtları/alarm-kaydını-güncelle"},{"title":"Şehirleri listele","deprecated":null,"version":null,"openapi":"/open-api/tr/geo-alarm_version-1.json get /v1/alarms/geometries/{countryCode}/cities","href":"/api-reference/coğrafi-alarm-kayıtları/şehirleri-listele"},{"title":"Mahalleleri listele","deprecated":null,"version":null,"openapi":"/open-api/tr/geo-alarm_version-1.json get /v1/alarms/geometries/neighborhoods/{districtId}","href":"/api-reference/coğrafi-alarm-kayıtları/mahalleleri-listele"},{"title":"Mahalle detayını getir","deprecated":null,"version":null,"openapi":"/open-api/tr/geo-alarm_version-1.json get /v1/alarms/geometries/neighborhood/{neighborhoodId}","href":"/api-reference/coğrafi-alarm-kayıtları/mahalle-detayını-getir"},{"title":"Alıcı kimliği ile getir","deprecated":null,"version":null,"openapi":"/open-api/tr/geo-alarm_version-1.json get /v1/alarms/geometries/get-by-recipient-id/{recipientId}","href":"/api-reference/coğrafi-alarm-kayıtları/alıcı-kimliği-ile-getir"},{"title":"Kayıt ID ile getir","deprecated":null,"version":null,"openapi":"/open-api/tr/geo-alarm_version-1.json get /v1/alarms/geometries/get-by-id/{registrationId}","href":"/api-reference/coğrafi-alarm-kayıtları/kayıt-id-ile-getir"},{"title":"İlçeleri listele","deprecated":null,"version":null,"openapi":"/open-api/tr/geo-alarm_version-1.json get /v1/alarms/geometries/districts/{cityId}","href":"/api-reference/coğrafi-alarm-kayıtları/i̇lçeleri-listele"},{"title":"İlçe detayını getir","deprecated":null,"version":null,"openapi":"/open-api/tr/geo-alarm_version-1.json get /v1/alarms/geometries/district/{districtId}","href":"/api-reference/coğrafi-alarm-kayıtları/i̇lçe-detayını-getir"},{"title":"Şehir detayını getir","deprecated":null,"version":null,"openapi":"/open-api/tr/geo-alarm_version-1.json get /v1/alarms/geometries/city/{cityId}","href":"/api-reference/coğrafi-alarm-kayıtları/şehir-detayını-getir"},{"title":"Alarm kaydını sil","deprecated":null,"version":null,"openapi":"/open-api/tr/geo-alarm_version-1.json delete /v1/alarms/geometries/unregister/{registrationId}","href":"/api-reference/coğrafi-alarm-kayıtları/alarm-kaydını-sil"}]}]},{"group":"Tahnin Alarm API","icon":"location-dot","pages":[{"group":"Tahmin Nokta Alarm Kayıtları","pages":[{"title":"Kayıt oluştur","deprecated":null,"version":null,"openapi":"/open-api/tr/forecast-alarm_version-1.json post /v1/alarms/forecasts/register","href":"/api-reference/tahmin-nokta-alarm-kayıtları/kayıt-oluştur"},{"title":"Kayıtları listele (sayfalı)","deprecated":null,"version":null,"openapi":"/open-api/tr/forecast-alarm_version-1.json post /v1/alarms/forecasts/page","href":"/api-reference/tahmin-nokta-alarm-kayıtları/kayıtları-listele-sayfalı"},{"title":"Kayıt güncelle","deprecated":null,"version":null,"openapi":"/open-api/tr/forecast-alarm_version-1.json patch /v1/alarms/forecasts/update","href":"/api-reference/tahmin-nokta-alarm-kayıtları/kayıt-güncelle"},{"title":"İlleri listele","deprecated":null,"version":null,"openapi":"/open-api/tr/forecast-alarm_version-1.json get /v1/alarms/forecasts/{countryCode}/cities","href":"/api-reference/tahmin-nokta-alarm-kayıtları/i̇lleri-listele"},{"title":"Alıcı ID’sine göre getir","deprecated":null,"version":null,"openapi":"/open-api/tr/forecast-alarm_version-1.json get /v1/alarms/forecasts/get-by-recipient-id/{recipientId}","href":"/api-reference/tahmin-nokta-alarm-kayıtları/alıcı-id’sine-göre-getir"},{"title":"Kayıt ID’sine göre getir","deprecated":null,"version":null,"openapi":"/open-api/tr/forecast-alarm_version-1.json get /v1/alarms/forecasts/get-by-id/{registrationId}","href":"/api-reference/tahmin-nokta-alarm-kayıtları/kayıt-id’sine-göre-getir"},{"title":"İlçeleri listele","deprecated":null,"version":null,"openapi":"/open-api/tr/forecast-alarm_version-1.json get /v1/alarms/forecasts/districts/{cityId}","href":"/api-reference/tahmin-nokta-alarm-kayıtları/i̇lçeleri-listele"},{"title":"İlçe getir","deprecated":null,"version":null,"openapi":"/open-api/tr/forecast-alarm_version-1.json get /v1/alarms/forecasts/district/{districtId}","href":"/api-reference/tahmin-nokta-alarm-kayıtları/i̇lçe-getir"},{"title":"İl getir","deprecated":null,"version":null,"openapi":"/open-api/tr/forecast-alarm_version-1.json get /v1/alarms/forecasts/city/{cityId}","href":"/api-reference/tahmin-nokta-alarm-kayıtları/i̇l-getir"},{"title":"Kaydı sil","deprecated":null,"version":null,"openapi":"/open-api/tr/forecast-alarm_version-1.json delete /v1/alarms/forecasts/unregister/{registrationId}","href":"/api-reference/tahmin-nokta-alarm-kayıtları/kaydı-sil"}]}]},{"group":"Güzergah API","icon":"route","tag":"YENİ","pages":[{"title":"Hizmet Detayları","icon":"route","tag":"YENİ","href":"/pages/tr/enroute"},{"group":"Enroute","pages":[{"title":"Rota hava durumunu getir","deprecated":null,"version":null,"openapi":"/open-api/tr/enroute_version-1.json post /v1/enroute/weather","href":"/api-reference/enroute/rota-hava-durumunu-getir"},{"title":"Rota kaydet","deprecated":null,"version":null,"openapi":"/open-api/tr/enroute_version-1.json post /v1/enroute/register","href":"/api-reference/enroute/rota-kaydet"}]}]}]}]},"basePath":"","title":"API Güvenliği - iklim.co API Documentation","deploymentId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","buildId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","dynamics":[],"chunks":[]}