Referans Icerik Modelleri

Veri kaynağı, medya ve özellik paketi 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ı: Veri kaynakları, medya, feature pack.

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

DataSourceConfig

Alan	Tür	Zorunlu	Varsayılan	Şema sınırları
name	string	Evet	—	—
enabled	boolean	Hayır	true	—
path	string | null	Hayır	null	—
type	enum ["json_file","yaml_file","csv_file","static","http"]	Evet	—	—
public	boolean	Hayır	false	—
public_write	boolean	Hayır	false	—
permission	string | null	Hayır	null	—
read_permission	string | null	Hayır	null	—
write_permission	string | null	Hayır	null	—
parameters	list[RequestParameterSpec]	Hayır	[]	—
file	string | null	Hayır	null	—
data	Any	Hayır	null	—
url	string | null	Hayır	null	—
method	enum ["GET","POST","PUT","PATCH","DELETE"]	Hayır	"GET"	—
headers	dict[str, string]	Hayır	{}	—
timeout_seconds	number	Hayır	10.0	>=0
max_response_bytes	integer	Hayır	2097152	min=1024; max=104857600
allow_insecure_http	boolean	Hayır	false	—
allow_private_networks	boolean	Hayır	false	—
retries	integer	Hayır	2	min=0; max=10
retry_non_idempotent	boolean	Hayır	false	—
writable	boolean	Hayır	false	—
file_lock_timeout_seconds	number	Hayır	5.0	max=60; >=0
id_field	string	Hayır	"id"	—
max_items	integer	Hayır	10000	min=1
allowed_filters	list[string]	Hayır	[]	—
allowed_sort	list[string]	Hayır	[]	—
cache_ttl_seconds	integer	Hayır	15	min=0
stale_ttl_seconds	integer | null	Hayır	null	min=0
forward_query	boolean	Hayır	true	—
forward_body	boolean	Hayır	true	—
dependencies	list[string]	Hayır	[]	—

MediaConfig

Alan	Tür	Zorunlu	Varsayılan	Şema sınırları
enabled	boolean	Hayır	false	—
backend	const "local"	Hayır	"local"	—
local_directory	string	Hayır	"./data/media"	—
max_upload_bytes	integer	Hayır	26214400	min=1; max=1073741824
max_batch_files	integer	Hayır	8	min=1; max=100
max_owner_bytes	integer | null	Hayır	null	min=1
allowed_mime_types	list[string]	Hayır	["image/jpeg","image/png","image/webp","image/gif","video/mp4","audio/mpeg","audio/ogg","application/pdf"]	—
allowed_extensions	list[string]	Hayır	[]	—
public	boolean	Hayır	false	—
upload_permission	string	Hayır	"media.upload"	—
read_permission	string	Hayır	"media.read"	—
delete_permission	string	Hayır	"media.delete"	—
admin_permission	string	Hayır	"media.admin"	—
owner_delete_only	boolean	Hayır	false	—
deduplicate	boolean	Hayır	true	—
deduplicate_scope	enum ["owner","project"]	Hayır	"owner"	—
signed_urls_enabled	boolean	Hayır	false	—
signing_secret	string | null	Hayır	null	—
signed_url_ttl_seconds	integer	Hayır	300	min=1; max=86400
post_upload_hooks	list[string]	Hayır	[]	—

FeaturePacksConfig

Alan	Tür	Zorunlu	Varsayılan	Şema sınırları
messaging	MessagingPackConfig	Hayır	MessagingPackConfig()	—
social	SocialPackConfig	Hayır	SocialPackConfig()	—
gaming	GamingPackConfig	Hayır	GamingPackConfig()	—

MessagingPackConfig

Alan	Tür	Zorunlu	Varsayılan	Şema sınırları
enabled	boolean	Hayır	false	—
table_prefix	string	Hayır	"msg_"	—
database	string	Hayır	"primary"	—
tenant_field	string | null	Hayır	null	—

SocialPackConfig

Alan	Tür	Zorunlu	Varsayılan	Şema sınırları
enabled	boolean	Hayır	false	—
table_prefix	string	Hayır	"social_"	—
database	string	Hayır	"primary"	—
tenant_field	string | null	Hayır	null	—

GamingPackConfig

Alan	Tür	Zorunlu	Varsayılan	Şema sınırları
enabled	boolean	Hayır	false	—
table_prefix	string	Hayır	"game_"	—
database	string	Hayır	"primary"	—
tenant_field	string | null	Hayır	null	—

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