> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.iklim.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Şifre Sıfırlama İsteği Yapılan İşlem

> Şifresini Unutan Kullanıcıların Şifre Sırıflramasını Talebini Alan İşlemdir. Bir Kullanıcı İçin Belirli Bir Periyot İçinde Şifre Sıfırlama Talebine Sınır Uygulanır. Bu Sınır Aşıldığında Tekrar Email Gönderilmez ve Hata Mesajı Döner.



## OpenAPI

````yaml /open-api/tr/auth-version-1.json post /v1/users/password-reset-request
openapi: 3.0.1
info:
  title: OpenAPI definition
  version: v0
servers:
  - url: https://api.iklim.co
    description: Production server
  - url: https://api-test.iklim.co
    description: Test server
  - url: http://localhost:8080
    description: Local development environment with api gateway
security: []
tags:
  - name: Kullanıcı Servisi
    description: Kullanıcı ile İlgili İşlemleri Yönetir
  - name: Yetklilendirme Servisi
    description: Yetkilendirme İşlemlerini Yönetir
paths:
  /v1/users/password-reset-request:
    post:
      tags:
        - Kullanıcı Servisi
      summary: Şifre Sıfırlama İsteği Yapılan İşlem
      description: >-
        Şifresini Unutan Kullanıcıların Şifre Sırıflramasını Talebini Alan
        İşlemdir. Bir Kullanıcı İçin Belirli Bir Periyot İçinde Şifre Sıfırlama
        Talebine Sınır Uygulanır. Bu Sınır Aşıldığında Tekrar Email Gönderilmez
        ve Hata Mesajı Döner.
      operationId: passwordResetRequest
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PasswordResetRequest'
        required: true
      responses:
        '200':
          description: Başarılı Şifre Sıfırlama İsteği
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PasswordResetResponse'
        '400':
          description: >-
            İstek Sırasında Gerekli Başlıklar Bulunamadı veya İstek Gövdesi
            Hatalı
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
              examples:
                Bad Request Example:
                  summary: Example response
                  description: Bad Request Example
                  value:
                    timestamp: '2025-04-14T16:26:54.203118461'
                    status: 400
                    error: Bad Request
                    message: Missing X-Idempotency-Key header
                    path: /endpoint/uri/here
        '401':
          description: Yetkisiz veya Hatalı İmza ile İstek
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
              examples:
                Unauthorized Example 1:
                  summary: Example response 1
                  description: Unauthorized Example 1
                  value:
                    timestamp: '2025-04-14T16:57:50.083970026'
                    status: 401
                    error: Unauthorized
                    message: Bad Credentials
                    path: /endpoint/uri/here
                Unauthorized Example 2:
                  summary: Example response 2
                  description: Unauthorized Example 2
                  value:
                    timestamp: '2025-04-14T16:57:50.083970026'
                    status: 401
                    error: Unauthorized
                    message: Invalid request signature
                    path: /auth/login
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
        '409':
          description: Mükerrer İstek Yapıldı
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
              examples:
                Conflict Example 1:
                  summary: Example response 1
                  description: Conflict Example 1
                  value:
                    timestamp: '2025-04-14T16:57:21.168927321'
                    status: 409
                    error: Conflict
                    message: Replay attack detected (nonce reused)
                    path: /endpoint/uri/here
                Conflict Example 2:
                  summary: Example response 2
                  description: Conflict Example 2
                  value:
                    timestamp: '2025-04-14T16:56:28.671809875'
                    status: 409
                    error: Conflict
                    message: Duplicate request detected (X-Idempotency-Key)
                    path: /endpoint/uri/here
        '500':
          description: İstek Sırasında Dahili Sunucu Hatası
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
              examples:
                Internal Server Error Example:
                  summary: Example response
                  description: Internal Server Error Example
                  value:
                    timestamp: '2025-04-14T16:58:10.414972912'
                    status: 500
                    error: Internal Server Error
                    message: An Error Occurred During Login
                    path: /endpoint/uri/here
components:
  schemas:
    PasswordResetRequest:
      required:
        - passwordResetPageLink
        - userName
      type: object
      properties:
        userName:
          type: string
          description: E-Posta Biçiminde Kullanıcı Adı
          example: name@email.com
        passwordResetPageLink:
          type: string
          description: >-
            Şifre Sıfırlama Sırasında Yeni Şifrenin Girileceği Sayfaya Giden
            Bağlantı. Bağlantı İçine Parametre Olarak Userid (u) ve Şifre
            Sıfırlama Belirteci (t) Eklenir.
          example: https://ui.iklim.co/reset-password
    PasswordResetResponse:
      type: object
      properties:
        userName:
          type: string
          description: Kullanıcı Adı
        userId:
          type: string
          description: Kullanıcı Kimlik Belirteci
        token:
          type: string
          description: Şifre Sıfırlama Belirteci
        tokenExpirationEpoch:
          type: integer
          description: >-
            Epoch Saniye Cinsinden Şifre Sıfırlama Belirtecinin Geçerli Olduğu
            Tarih
          format: int64
    StandardErrorResponse:
      required:
        - error
        - message
        - path
        - status
        - timestamp
      type: object
      properties:
        timestamp:
          type: string
          description: Hata Zaman Damgası
          format: date-time
        status:
          type: integer
          description: Hata Durum Kodu
          format: int32
        error:
          type: string
          description: Hata Adı
          example: Error Name
        message:
          type: string
          description: Hata Açıklaması
          example: Error Message
        path:
          type: string
          description: Hata Veren Endpoint URI
          example: /endpoint/uri/here

````