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

# Kimlik Doğrulama

> 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.

<Danger>
  Tüm yetkili uç noktalar istekte `Authorization: Bearer <ACCESS_TOKEN>` başlığı gerektirir!<br />
  Aksi takdirde API istemcisi durum `401 - Yetkisiz` ile bir hata mesajı alacaktır
</Danger>

Örnek Başlık:

```ini theme={null}
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJtdXJhdG96ZGVtaXJAdGFybGEuaW8iLCJ1c2VySWQiOiJjOGI1OTQwZS01M2QyLTQwZGYtYTg4Yi0xMTBjODYxNTVjZmEiLCJyb2xlcyI6WyJBUElfVVNFUiIsIkFETUlOIl0sImxvY2FsZSI6InRyX1RSIiwidGltZVpvbmUiOiJFdXJvcGUvSXN0YW5idWwiLCJpYXQiOjE3NTMyMTA2MzQsImV4cCI6MTc1MzIxNDIzNH0.hfF1bjcNDhVthtpaZ_HkysA-zJH3VN1a6Sr59aRZbk0
```

# 1. Giriş İşlemi

> Kullanıcı Adı ve Şifre ile Giriş İşlemleri Yapılır<br />
> API Uç Noktası: `/v1/auth/login`

Örnek İstek Gövdesi:

```json theme={null}
{
  "username": "name@domain.com",
  "password": "password"
}
```

Örnek Başarılı Yanıt:

```json theme={null}
{
    "username": "name@domain.com",
    "type": "Bearer",
    "accessToken": "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJtdXJhdG96ZGVtaXJAdGFybGEuaW8iLCJ1c2VySWQiOiJjOGI1OTQwZS01M2QyLTQwZGYtYTg4Yi0xMTBjODYxNTVjZmEiLCJyb2xlcyI6WyJBUElfVVNFUiIsIkFETUlOIl0sImxvY2FsZSI6InRyX1RSIiwidGltZVpvbmUiOiJFdXJvcGUvSXN0YW5idWwiLCJpYXQiOjE3NTMyMDc1OTAsImV4cCI6MTc1MzIxMTE5MH0.fTCunl7i7yQ8nAuughBpvpRfdH8VFK8uhZWeTrDOPAc",
    "refreshToken": "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJtdXJhdG96ZGVtaXJAdGFybGEuaW8iLCJ1c2VySWQiOiJjOGI1OTQwZS01M2QyLTQwZGYtYTg4Yi0xMTBjODYxNTVjZmEiLCJsb2NhbGUiOiJ0cl9UUiIsInRpbWVab25lIjoiRXVyb3BlL0lzdGFuYnVsIiwiaWF0IjoxNzUzMjA3NTkwLCJleHAiOjE3NTMyOTM5OTB9.ozFiZzNPSUtzwvu3wuocA8q8t6MlqbyT6On2i0vSENQ"
}
```

<Tip>
  Erişim belirteçleri sadece 1 saat için geçerlidir. Yenileme belirteçleri ise 1 gün boyunca geçerlidir!
</Tip>

Olası Hata Yanıtları:

```json theme={null}
{
  "timestamp": "2025-04-14T16:58:22.22308754",
  "status": 401,
  "error": "Yetkisiz",
  "message": "Hatalı kimlik bilgileri",
  "path": "/auth/login"
}
```

```json theme={null}
{
"timestamp": "2025-04-21T16:35:54.095818",
"status": 401,
"error": "Yetkisiz",
"message": "Kullanıcı devre dışı",
"path": "/auth/login"
}
```

# 2. Erişim Belirteci Yenileme İşlemi

> Erişim belirtecinin süresi dolduğunda, yenileme belirteci kullanılarak yenilenir<br />
> API Uç Noktası: `/v1/auth/refresh`

Örnek İstek Gövdesi:

```json theme={null}
{
  "refreshToken": "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJtdXJhdG96ZGVtaXJAdGFybGEuaW8iLCJ1c2VySWQiOiJjOGI1OTQwZS01M2QyLTQwZGYtYTg4Yi0xMTBjODYxNTVjZmEiLCJsb2NhbGUiOiJ0cl9UUiIsInRpbWVab25lIjoiRXVyb3BlL0lzdGFuYnVsIiwiaWF0IjoxNzUzMjA3NTkwLCJleHAiOjE3NTMyOTM5OTB9.ozFiZzNPSUtzwvu3wuocA8q8t6MlqbyT6On2i0vSENQ"
}
```

Cevaplar `Giriş İşlemi`'ne benzeridir.

<Warning>
  API isteklerinize `401 - Yetkisiz` yanıtı alırsanız, erişim belirtecinizi yenileyin.<br />
  Belirteci Yenileme isteklerinize hala `401 - Yetkisiz` yanıtı alıyorsanız, lütfen devam etmeden önce Giriş yapın!
</Warning>