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

# Ortamlar ve adresler

> Canlı ve test ortamlarının adreslerini, kimlik sunucusunu ve API sürüm önekini listeler.

Flextell API'si iki ortamda çalışır: canlı ve test. Her ortamın iki adresi vardır: istekleri gönderdiğiniz **API adresi** ve token aldığınız **kimlik sunucusu**. Entegrasyonunuzu yazarken bu iki adresi aynı ortamdan seçin.

## Ortamlar

| Ortam | API adresi | Kimlik sunucusu |
| - | - | - |
| Canlı | `https://app.flextell.ai/api/v1` | `https://id.flextell.ai` |
| Test | `https://dev.flextell.ai/api/v1` | `https://iddev.flextell.ai` |

<Tip>
  Entegrasyonunuzu önce test ortamında deneyin. Adresleri koda gömmek yerine ortam değişkeni veya yapılandırma dosyasında tutun. Böylece ortam değiştirmek için tek bir değeri güncellemeniz yeterli olur.
</Tip>

## API adresi

Tüm kaynak uç noktaları API adresinin altındadır. Bu dokümandaki örnekler canlı adresi kullanır.

```bash theme={null}
curl "https://app.flextell.ai/api/v1/account" \
  -H "Authorization: Bearer <access_token>" \
  -H "Accept: application/json"
```

Her istekte `Authorization` başlığı gerekir. Klinik verisine erişen uç noktalarda ayrıca `X-Tenant: <tenant_id>` başlığını gönderin. Başlıkların tam listesi için [İstek başlıkları](/api/istekler/basliklar) ve [Klinikler ve X-Tenant](/api/klinikler-ve-x-tenant) sayfalarına bakın.

API adresiyle aynı makinede kimlik doğrulaması gerektirmeyen birkaç yol da bulunur:

| Yol | Ne işe yarar |
| - | - |
| `/up` | Sağlık denetimi. |
| `/docs/api` | Etkileşimli API referansı. |
| `/docs/api.json` | OpenAPI belgesi (OpenAPI 3.1). |

Bu yollar `/api/v1` önekini taşımaz. Örneğin canlı ortamda sağlık denetimi `https://app.flextell.ai/up` adresindedir.

## Kimlik sunucusu

Token'ları kimlik sunucusundan alırsınız. API adresi ise yalnızca bu token'ları kabul eder. Kimlik sunucusunun başlıca adresleri:

| Amaç | Yol |
| - | - |
| Keşif belgesi | `/.well-known/openid-configuration` |
| Yetkilendirme | `/oauth/authorize` |
| Token | `/oauth/token` |
| Kullanıcı bilgisi | `/oauth/userinfo` |
| Genel anahtarlar (JWKS) | `/oauth/jwks` |
| Oturumu kapatma | `/oauth/logout` |

Canlı ortamda yetkilendirme adresi `https://id.flextell.ai/oauth/authorize`, token adresi `https://id.flextell.ai/oauth/token` olur. Test ortamında `id.flextell.ai` yerine `iddev.flextell.ai` yazın.

Keşif belgesi desteklenen yetkilendirme akışlarını, imza algoritmasını ve `scope` listesini bildirir. İstemci kitaplığınız keşif belgesini okuyabiliyorsa yalnızca kimlik sunucusunun adresini vermeniz yeterlidir.

<Warning>
  Yetkilendirme ve token isteklerini her zaman kimlik sunucusuna gönderin (`id.flextell.ai` veya `iddev.flextell.ai`). API adresi olan `app.flextell.ai` ve `dev.flextell.ai` üzerinde de eski OAuth yolları görünebilir. Yeni entegrasyonlarda bunları kullanmayın.
</Warning>

Akışın adımları için [Kimlik doğrulama genel bakış](/api/kimlik-dogrulama/genel-bakis) ve [OpenID Connect](/api/kimlik-dogrulama/openid-connect) sayfalarına geçin.

## Sürüm öneki

Tüm kaynak uç noktaları `/api/v1` önekiyle başlar. Şu anda tek sürüm `v1`'dir; `v2` yoktur.

```text theme={null}
https://app.flextell.ai/api/v1/<kaynak>
```

Önek yalnızca REST kaynaklarını kapsar. Şu yollar sürümsüzdür:

| Yol | Ne için |
| - | - |
| `/api/broadcasting/auth` | Gerçek zamanlı kanallara abone olma yetkisi. Bkz. [Gerçek zamanlı genel bakış](/api/gercek-zamanli/genel-bakis). |
| `/webhook/*` | WhatsApp ve Telegram'dan gelen olaylar. |
| `/widget/{token}/*` | Web sitesi widget'ı. |
| `/veri-imha/{token}` | Hastanın veri imha onay sayfası. |
| `/oauth/logout` | Oturumu kapatma. |

<Note>
  Kırıcı değişiklikler yeni bir sürüm numarasıyla değil, `v1` içinde yayımlanır. Yanıtlarda `Deprecation` veya `Sunset` başlığı yoktur. Değişiklikleri [API değişiklikleri](/surum-notlari/api-degisiklikleri) sayfasından takip edin. Sürümleme ilkesinin ayrıntısı [Sürümleme](/api/istekler/surumleme) sayfasındadır.
</Note>

## API referansı ve OpenAPI belgesi

Her uç noktanın parametrelerini, şemalarını ve yanıtlarını OpenAPI belgesinde bulursunuz. Belge herkese açıktır; erişmek için token gerekmez.

| Ortam | Etkileşimli referans | OpenAPI belgesi |
| - | - | - |
| Canlı | `https://app.flextell.ai/docs/api` | `https://app.flextell.ai/docs/api.json` |
| Test | `https://dev.flextell.ai/docs/api` | `https://dev.flextell.ai/docs/api.json` |

OpenAPI belgesini Postman, Insomnia gibi araçlara aktarabilir veya istemci kodu üretmek için kullanabilirsiniz. Belgede sunucu adresi `https://app.flextell.ai/api` biçimindedir ve tüm yollar `/v1/...` ile başlar. Aynı adresi `/api/v1` önekiyle birleştirmeyin, yoksa önek iki kez yazılır.

<Warning>
  OpenAPI belgesindeki güvenlik şeması, yetkilendirme ve token adreslerini API adresinin altında gösterir ve tek bir `*` scope'u tanımlar. Bu bilgileri kullanmayın. Adresler için yukarıdaki [Kimlik sunucusu](#kimlik-sunucusu) bölümüne, scope listesi için [Scope'lar](/api/kimlik-dogrulama/scopelar) sayfasına bakın. Belgenin `info.version` değeri (`0.0.1`) sürümlerle birlikte değişmez; API sürümü için yol önekine güvenin.
</Warning>

## Sonraki adımlar

<CardGroup cols={2}>
  <Card title="Hızlı başlangıç" icon="rocket" href="/api/hizli-baslangic">
    Uygulama oluşturun, token alın ve ilk isteği gönderin.
  </Card>

  <Card title="Kimlik doğrulama" icon="key-round" href="/api/kimlik-dogrulama/genel-bakis">
    OAuth 2.0 akışını ve token türlerini öğrenin.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.