> ## Documentation Index
> Fetch the complete documentation index at: https://tahsil.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Kimlik doğrulama

> Müşteri API'sinde Bearer access token kullanımını güvenli biçimde uygulayın.

Tahsil kullanıcı API'si Bearer oturumuyla çalışır. Login ve refresh uçları dışında korumalı çağrılar geçerli bir access token ister.

## Oturum açma

```bash theme={"system"}
curl --request POST \
  --url https://api.tahsil.dev/auth/login \
  --header 'content-type: application/json' \
  --data '{"email":"developer@example.com","password":"example-password"}'
```

Başarılı cevap kısa ömürlü `accessToken`, refresh bilgisi, aktif firma ve membership listesini döndürür. Access token çağrılarda kullanılır:

```http theme={"system"}
Authorization: Bearer eyJ...
```

## Web oturumu

Web oturumlarında `x-auth-mode: cookie` gönderildiğinde refresh token `HttpOnly` cookie içinde tutulur. İstemci `credentials: include` kullanmalı; sayfa yenilemede önce `/auth/refresh`, sonra `/auth/me` çağrılmalıdır.

Access token yalnız uygulama belleğinde tutulur. Refresh token, access token, parola ve banka credential değerlerini localStorage, log veya analytics içine yazmayın.

## API referansında canlı test

Salt okunur bir endpoint sayfasında **Test Request** bölümünü açın ve yalnız kısa ömürlü access token'ı Bearer alanına girin. İstek doğrudan `api.tahsil.dev` adresine gider; Mintlify proxy'si kullanılmaz.

Test bittiğinde token alanını temizleyin ve sekmeyi kapatın. Login, refresh, logout, parola değişikliği ve veri değiştiren tüm operasyonlar canlı çalıştırmaya kapalıdır.

## Çıkış

`POST /auth/logout` refresh oturumunu geçersiz kılar ve cookie tabanlı kullanımda oturum cookie'sini temizler.

<Note>
  Banka credential yönetimi, setup, manuel sync ve otomasyon işlemleri yalnız `admin` veya `operator` rolündeki kullanıcılar için açıktır.
</Note>


## Related topics

- [Webhook ve imza doğrulama](/rehberler/odemeler/webhooklar.md)
- [Routing ve failover](/rehberler/odemeler/routing-ve-failover.md)
- [Banka hareketleri](/rehberler/hareketler.md)
- [Firma kapsamı](/baslangic/firma-kapsami.md)
- [Sanal POS kurulumu](/rehberler/odemeler/sanal-pos-kurulumu.md)