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

# İstek Header'ları

> Her Flextell API isteğinde göndermeniz gereken (ve gönderebileceğiniz) HTTP header'larının referansı.

Flextell API, standart bir REST + JSON arayüzüdür. Aşağıdaki header'ları isteklerinize dâhil edin.

## Zorunlu header'lar

<ParamField header="Authorization" type="string" required>
  Access token'ınızı `Bearer` şeması ile gönderin:

  ```
  Authorization: Bearer eyJ0eXAiOiJKV1Q...
  ```
</ParamField>

<ParamField header="X-Tenant" type="string" required>
  İşlem yapılacak kliniğin (tenant) ID'si. `/v1/account/*` ve `/v1/exchange-rates` uçları dışında her endpoint için zorunludur. Detay: [Multi-Tenancy](/tenancy/overview).
</ParamField>

<ParamField header="Accept" type="string" required>
  Her zaman `application/json` gönderin.
</ParamField>

## Yazma istekleri için

<ParamField header="Content-Type" type="string">
  JSON body içeren istekler (`POST`, `PUT`, `PATCH`) için `application/json`. Dosya yüklemeleri için `multipart/form-data` — bkz. [Dosya Yükleme](/requests/file-uploads).

  <Warning>
    JSON içerikli bir istekte gövde geçerli JSON olmazsa API `400 Bad Request` ve `"The request body contains malformed JSON."` mesajı döner.
  </Warning>
</ParamField>

## Opsiyonel header'lar

<ParamField header="Accept-Language" type="string">
  Yanıtlardaki doğrulama ve hata mesajlarının dili. Desteklenen: `tr` (varsayılan), `en`. Örnek:

  ```
  Accept-Language: en
  ```
</ParamField>

<ParamField header="User-Agent" type="string">
  Entegrasyonunuzu tanımlayan bir User-Agent değeri göndermenizi öneririz. Destek ekibinin log'larda sizi tanımasını kolaylaştırır:

  ```
  User-Agent: AcmeCRM/1.2.3 (+https://acmecrm.example.com)
  ```
</ParamField>

## Yanıt header'ları

Flextell yanıtlarında dikkat edilmesi gereken başlıca header'lar:

| Header                  | Anlamı                                                                    |
| ----------------------- | ------------------------------------------------------------------------- |
| `Content-Type`          | Her zaman `application/json`.                                             |
| `X-RateLimit-Limit`     | Bu endpoint için dakikadaki maksimum istek sayısı.                        |
| `X-RateLimit-Remaining` | Mevcut pencerede kalan kota.                                              |
| `Retry-After`           | `429` yanıtında, yeniden denemeden önce beklemeniz gereken saniye sayısı. |

Detaylar: [Rate Limiting](/requests/rate-limiting).

## Tam örnek

```bash theme={null}
curl --request POST \
  --url https://dev.flextell.ai/api/v1/customers \
  --header "Authorization: Bearer $TOKEN" \
  --header "X-Tenant: 12" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --header "Accept-Language: tr" \
  --header "User-Agent: AcmeCRM/1.2.3" \
  --data '{
    "first_name": "Ayşe",
    "last_name": "Demir",
    "phone_number": "+905551234567"
  }'
```