Repository navigation
Baslangic ve Urunler
English · Türkçe · Languages / Diller
Kapsam: JSON API Forge 0.5.1 · İnceleme: 17 Eylül 2026 · Dil: Türkçe
JSON API Forge, tekrar eden backend işlerini numaralı JSON belgeleriyle tanımlamanızı sağlayan, FastAPI üzerinde çalışan bir sunucu sistemidir. Kaynak, CRUD politikaları, veritabanı bağlantıları, SQL işlemleri, kimlik doğrulama, cache ve olay kanalları açık yapılandırmalardır. İş kuralları JSON ile anlaşılır biçimde ifade edilemiyorsa Python hook kullanılır.
Amaç yeni bir backend geliştirme yolu oluşturmaktır: davranışı görünür tutmak, tekrarlanan altyapı kodunu azaltmak ve kendi altyapınızda çalıştırabilmek. JSON API Forge her iş kuralını kendiliğinden çözmez; veri modeli, yetki sınırları ve dağıtım kararları uygulamaya aittir.
| Parça | Git dalı | İşlev | Tek başına backend çalıştırır mı? |
|---|---|---|---|
| Sunucu/runtime | main |
FastAPI uygulaması, CLI, şemalar, veritabanı ve HTTP yüzeyleri | Evet; önce uygulama oluşturulur |
| Python SDK | python-library |
Uzak sunucuya sync/async istek, cluster ve yönetim istemcileri | Hayır |
| Masaüstü Editör | Editor |
C++20/Qt 6 ile JSON, görsel form ve graph düzenleme | Hayır; runtime ayrı çalışır |
| Örnek uygulamalar | exampleApps |
25 bağımsız yapılandırma projesi |
main runtime ile |
Dal adları büyük/küçük harfe duyarlıdır: Editor kullanılır. Bu dallar birleştirilmesi beklenen geçici özellik dalları değildir. Her biri ayrı ürün dosyalarına ve CI iş akışına sahiptir; tam ağaçlarını birbirine merge etmeyin.
- Sunucuyu kurun, ardından ilk API'yi oluşturun.
- JSON birleştirme kurallarını, CRUD ve yetki modelini öğrenin.
- Python SDK veya Editör ile bağlanın.
- Birden fazla SQL adımı için RPC ve idempotency, özel iş mantığı için hook kullanın.
- Canlıya geçerken üretim dağıtımı, gözlemlenebilirlik ve bilinen sınırlar sayfalarını uygulayın.
0.5.1 framework/SDK/Editör sürümüdür. app.json içindeki version, sizin uygulamanızın sürümüdür. /api/my-service/v1 içindeki v1 ise HTTP sözleşmenizdir. Birinin artması diğerlerini kendiliğinden değiştirmez.
Proje source-available modelindedir. Kaynak kodunun açık görünmesi, alternatif dağıtım hakkı vermez. Resmi dağıtım merkezi olarak yönetilir; ayrıntılar Lisans ve katkı sayfasındadır. Wiki kullanım kılavuzudur; lisansın yerine geçmez.
Bu sayfa aşağıdaki sabit commitlerdeki davranışı açıklar. Yeni bir sürümde aynı davranışın sürdüğünü varsaymayın.