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

# Uygulamalar

> OAuthClient — dış uygulamaların Flextell verisine erişimi.

Uygulama (`OAuthClient`), Flextell verisine OAuth 2.0 üzerinden erişen dış sistemdir. Bir entegratörün, kendi yazılımının veya üçüncü tarafın firmanız adına API çağrıları yapması için **uygulama tanımı** gerekir.

## Yapı

Panel'de "Uygulamalar" başlığı altında listelenir; arka planda **`OAuthClient`** olarak saklanır. Her uygulama:

* Bir **istemci kimliği** (`client_id`) ve **gizli anahtar** (`client_secret`) alır
* Bir veya daha fazla **scope** (yetki) seçimi yapar
* Bir **redirect URI** tanımlar

## Yetki kapsamları (`OAuthScope`)

Scope'lar, uygulamanın hangi API uçlarına ulaşabileceğini sınırlar:

| Tipik scope           | Erişim                            |
| --------------------- | --------------------------------- |
| `customers:read`      | Hasta listeleme/okuma             |
| `customers:write`     | Hasta oluşturma/güncelleme        |
| `appointments:read`   | Randevu listeleme                 |
| `appointments:write`  | Randevu oluşturma                 |
| `conversations:read`  | Sohbet okuma                      |
| `conversations:write` | Asistan kontrolü / mesaj gönderme |
| `channels:read`       | Kanal listeleme                   |

Tam liste için API tarafı: [Scopes](/authentication/scopes).

## Akış

```mermaid theme={null}
sequenceDiagram
    participant E as Dış uygulama
    participant U as Kullanıcı
    participant F as Flextell

    E->>F: Authorization Code akışı
    F->>U: Onay ekranı (hangi scope'lar)
    U->>F: İzin ver
    F-->>E: Code → Access token
    E->>F: API çağrısı + Bearer token + X-Tenant
    F-->>E: Yanıt
```

Detay: [Authentication](/authentication/overview).

## Sonraki adımlar

<CardGroup cols={2}>
  <Card title="OAuth Scopes" icon="key" href="/authentication/scopes">
    Yetki kapsamları tam listesi.
  </Card>

  <Card title="Authorization Code" icon="lock" href="/authentication/authorization-code">
    OAuth 2.0 akış detayı.
  </Card>
</CardGroup>