Referans Runtime Modelleri

Cache, realtime, event ve gözlem alanları

English · Türkçe · Languages / Diller

Kapsam: JSON API Forge 0.5.1 · İnceleme: 17 Eylül 2026 · Dil: Türkçe

Bu tablo sabit committeki Pydantic modeli ve JSON Schema’dan üretilmiştir. Kullanım açıklamaları: Cache, realtime, gözlem.

“Zorunlu” alanın JSON’da bulunma zorunluluğudur; null kabulü ayrı bir tür kuralıdır. Model() varsayılanı, ilgili modelin bu sayfalardaki varsayılanlarıyla oluşturulmasıdır. Boş liste/nesne varsayılanları her model için ayrı üretilir. —, varsayılan veya o sütunda şema sınırı olmadığını belirtir.

Tablodaki sınırlara ek olarak alanlar arası doğrulayıcılar vardır: izin/public seçimi, URL/host güvenliği, tenant/owner sütunları, cache/idempotency/transaction birlikteliği, şema çakışmaları ve güvenli regex bunlara dahildir. JSON Schema doğrulaması tek başına forge validate yerine geçmez. extra="forbid" nedeniyle bilinmeyen alanlar reddedilir.

CacheConfig

Alan	Tür	Zorunlu	Varsayılan	Şema sınırları
enabled	boolean	Hayır	true	—
backend	enum ["memory","redis","tiered"]	Hayır	"memory"	—
default_ttl_seconds	integer	Hayır	30	min=1
stale_ttl_seconds	integer	Hayır	0	min=0
max_entries	integer	Hayır	10000	min=100
key_prefix	string	Hayır	"forge"	—
cache_lists	boolean	Hayır	true	—
cache_reads	boolean	Hayır	true	—
fail_open	boolean	Hayır	true	—

RealtimeConfig

Alan	Tür	Zorunlu	Varsayılan	Şema sınırları
backend	enum ["memory","redis"]	Hayır	"memory"	—
redis_prefix	string	Hayır	"forge:events"	—

EventChannelConfig

Alan	Tür	Zorunlu	Varsayılan	Şema sınırları
name	string	Evet	—	—
path	string | null	Hayır	null	—
public_publish	boolean	Hayır	false	—
public_subscribe	boolean	Hayır	false	—
publish_permission	string | null	Hayır	null	—
subscribe_permission	string | null	Hayır	null	—
websocket_enabled	boolean	Hayır	true	—
sse_enabled	boolean	Hayır	true	—
max_message_bytes	integer	Hayır	65536	min=128; max=1048576
queue_size	integer	Hayır	256	min=1; max=10000
max_websocket_connections	integer	Hayır	1000	min=1; max=100000
max_sse_connections	integer	Hayır	1000	min=1; max=100000
allowed_origins	list[string]	Hayır	[]	—
heartbeat_seconds	integer	Hayır	15	min=1
websocket_message_requests	integer | null	Hayır	null	min=1
websocket_message_window_seconds	integer | null	Hayır	null	min=1
websocket_message_burst	integer | null	Hayır	null	min=1

WebhookDocConfig

Alan	Tür	Zorunlu	Varsayılan	Şema sınırları
name	string	Evet	—	—
method	enum ["POST","PUT","PATCH"]	Hayır	"POST"	—
summary	string | null	Hayır	null	—
description	string | null	Hayır	null	—
payload_schema	object | null	Hayır	null	—

ObservabilityConfig

Alan	Tür	Zorunlu	Varsayılan	Şema sınırları
metrics_enabled	boolean	Hayır	true	—
metrics_path	string	Hayır	"/metrics"	—

Kaynak ve doğrulama

Bu sayfa aşağıdaki sabit commitlerdeki davranışı açıklar. Yeni bir sürümde aynı davranışın sürdüğünü varsaymayın.

• main/framework/config.py
• main/schemas/project.schema.json
• main/framework/validation.py

---

Wiki ana sayfa · Tüm sayfalar · Sürüm ve bakım