> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# API modülü

Sürümlenmiş genel sözleşme, anahtar tesisatı ve OpenAPI yüzeyi.

## Başlamadan önce

İndirdiğiniz supastack projenizi Visual Studio Code'de Dosya → Klasörü Aç'ı kullanarak açın ve ardından Terminal → Yeni Terminal'i seçin. Depo kökü package.json'u, uygulamaları ve paketleri içeren klasördür. Aşağıdaki komutu orada çalıştırın ve terminalini açık bırakın. Bir komut tanınmazsa devam etmeden önce araç kurulum kılavuzunu tamamlayın.

Önce platform eğitimini okuyun. Sunucu, tarayıcı veya telefon isteklerini yanıtlayan uygulama işlemidir. Web, apps/web/.env.local'yi okur, Expo, apps/mobile/.env.local'yi okur ve veritabanı geçiş komutları root .env'yi okur. Veritabanı olmayan/gösterge paneli gösterimi, Postgres'nin taşınmasını gerektiren gerçek/auth hesaplarından ayrıdır. Yalnızca telefona veya masaüstüne yönelik bir ödeme, ayrı olarak çalışan bir Web arka ucuna ihtiyaç duyar.

[Araçları yükleyin ve kodu alın](https://supastack.dev/tr/docs/web/before-you-start.md)

[Komutları, dosyaları ve yapılandırmayı öğrenin](https://supastack.dev/tr/docs/web/terminal-basics.md)

[Web'de ilk çalıştırma eğitimini tamamlayın](https://supastack.dev/tr/docs/web/ship-in-5-minutes.md)

```
corepack pnpm --filter @supastack/web dev
```


## Kurulum ve yapılandırma

packages/api, genel REST yüzeyinin doğruluk kaynağıdır: istekler, yanıtlar ve hata zarfı için zod şemaları ile /api/v1/openapi'de sunulan OpenAPI belgesi (openApiDocument). Rota işleyicileri şekilleri yeniden tanımlamak yerine bu şemaları bir araya getirir.

API anahtarları çalışma alanı başına sk_<env>_ önekiyle düzenlenir, sabit zamanlı karşılaştırmayla karma saklanır ve kapsam taşır — varsayılan okuma. api-keys.ts oluşturma, arama ve iptali sahiplenir.

```
apiV1 = "/api/v1"

schemas: currentWorkspace, entitlement,
  modelRequirements, createAiTaskRequest,
  aiTask, aiTaskResult, apiError

openApiDocument → GET /api/v1/openapi
```


## Uygulama iş akışı

Uç noktaları mevcut sürüm içine ekleyin: şemaları genişletin, hata zarfını koruyun ve /api/docs doğru kalsın diye OpenAPI yüzeyini yeniden üretin. Kırıcı değişiklikler sessiz şekil değişikliği değil, yeni sürüm alır.

Çağıranın çalışma alanını sunulan anahtardan çözün, web uygulamasıyla aynı yetkilendirme ve doğrulama kurallarını uygulayın ve anahtar başına hız sınırlayın.


## Doğrulama ve sorun giderme

Her rota şeklini paket şemalarına karşı sözleşme testi yapın. Bilinmeyen anahtarların, iptal edilmiş anahtarların ve yetersiz kapsamlı isteklerin hepsinin belgelenen hata zarfıyla başarısız olduğunu ve OpenAPI belgesinin geçerli JSON kaldığını doğrulayın.


## Sonraki

[Hız sınırlama](https://supastack.dev/tr/docs/modules/rate-limiting.md)