Enum Referansı

API'nin filtre parametreleri ve yanıt alanlarında kullanılan tüm enum'ların tam değer-isim eşlemesi. Etiket enum'ları (InstitutionType, DepartmentType, TopicType) sayı olarak gönderilir; aksiyon, ciddiyet ve son tarih türü gibi enum'lar isim string'i olarak gönderilir, yanıtlarda sayı olarak döner.

Hızlı Tablo — Hangi Enum, Nasıl Gönderilir, Nasıl Döner

Enum	İstekte (filtre)	Yanıtta
InstitutionType	sayı (?institutionTypes=1)	sayı dizisi (*)
DepartmentType	sayı (?departments=1)	sayı dizisi (*)
TopicType	sayı (?topics=1)	sayı dizisi (*)
ObligationActionType	isim (?actionTypes=Report)	sayı
ObligationSeverity	isim (?severityMin=High)	sayı
DeadlineKind	(filtre yok)	sayı
DocumentFormat	(filtre yok)	sayı

(*) İstisna: /library/{id} etiket dizilerini insan-okunabilir Türkçe etiket string'i olarak döner (örn. ["Banka", "Ödeme Kuruluşu"]), sayı dizisi olarak değil. Diğer tüm uç noktalar (/obligations/{id}, /library/{id}/obligations, /subscriptions/profile) sayı dizisi döner. Client'larınızda /library/{id} için ayrı bir mapper kullanın veya integer karşılığını talep ediyorsanız /obligations/{id} üzerinden çekin.

---

InstitutionType — Kurum Tipleri

Yükümlü taraf — etkilenen finansal kuruluş kategorisi.

ID	Enum İsmi	Açıklama
1	Banka	Mevduat bankaları (klasik bankacılık)
2	KatilimBankasi	Katılım bankaları (faizsiz)
3	FinansalKiralamaSirketi	Finansal kiralama (leasing) şirketleri
4	FaktoringSirketi	Faktoring şirketleri
5	FinansmanSirketi	Finansman şirketleri (tüketici/taşıt)
6	TasarrufFinansmanSirketi	Tasarrufa dayalı faizsiz finansman
7	VarlikYonetimSirketi	Varlık yönetim şirketleri
8	OdemeKurulusu	Ödeme hizmetleri sağlayıcıları
9	ElektronikParaKurulusu	Elektronik para kuruluşları
10	AraciKurum	SPK aracı kurumlar (SermayePiyasasiKurulusu yerine)
11	PortfoyYonetimSirketi	Portföy yönetim şirketleri
12	YatirimFonu	Yatırım ve menkul kıymet fonları
13	KriptoVarlikHizmetSaglayici	Kripto varlık hizmet sağlayıcılar
14	SigortaSirketi	Sigorta şirketleri
15	ReasuransSirketi	Reasürans şirketleri
16	EmeklilikSirketi	Emeklilik şirketleri
17	GayrimenkulDegerlemeSirketi	Gayrimenkul değerleme şirketleri
18	BagimsizDenetimKurulusu	Bağımsız denetim kuruluşları
19	FinansalHolding	Finansal holding şirketleri (eskiden Fintech)
20	TumFinansalKuruluslar	Tüm finansal kuruluşlara uygulanan yatay düzenlemeler
21	TumKamuSermayeliFinansalKuruluslar	Tüm kamu sermayeli finansal kuruluşlar

---

DepartmentType — Departmanlar

Yükümlülüğü hayata geçirmesi beklenen iç birim.

ID	Enum İsmi	Departman
1	Uyum	Uyum (Compliance)
2	IcDenetim	İç Denetim
3	IcKontrol	İç Kontrol
4	Hukuk	Hukuk
5	RiskYonetimi	Risk Yönetimi
6	FinansalRaporlama	Finansal Raporlama (eskiden Finans)
7	MuhasebeVergi	Muhasebe & Vergi
8	Hazine	Hazine
9	KrediTahsis	Kredi Tahsis (eskiden Kredi)
10	Operasyon	Operasyon
11	BilgiTeknolojileri	Bilgi Teknolojileri
12	BilgiGuvenligi	Bilgi Güvenliği
13	VeriKoruma	Veri Koruma (KVKK)
14	OdemeSistemleri	Ödeme Sistemleri
15	SatinAlmaIdari	Satın Alma & İdari (eskiden SatinAlma)
16	PazarlamaUrun	Pazarlama & Ürün (Pazarlama+Ürün birleşti)
17	BireyselPerakende	Bireysel & Perakende Bankacılık
18	KurumsalTicari	Kurumsal & Ticari Bankacılık
19	MusteriDeneyimi	Müşteri Deneyimi & Şikayet Yönetimi
20	InsanKaynaklari	İnsan Kaynakları
21	KurumsalIletisim	Kurumsal İletişim
22	YatirimciIliskileri	Yatırımcı İlişkileri
23	SurdurulebilirlikESG	Sürdürülebilirlik & ESG
24	StratejiIsGelistirme	Strateji & İş Geliştirme (eskiden Strateji)

---

TopicType — Konular

Düzenleyici çerçevenin konu başlığı.

ID	Enum İsmi	Konu
1	AmlCft	AML / CFT (Aklama ve Terörün Finansmanı ile Mücadele)
2	IhtiyatiDuzenleme	İhtiyati düzenleme
3	SermayeYeterliligi	Sermaye yeterliliği
4	LikiditeYonetimi	Likidite yönetimi (eskiden Likidite)
5	DuzenleyiciRaporlama	Düzenleyici raporlama (eskiden Raporlama)
6	KamuyuAydinlatma	Kamuyu aydınlatma
7	TuketiciKoruma	Tüketici koruma
8	VeriGizliligi	Veri gizliliği (KVKK)
9	SiberGuvenlik	Siber güvenlik
10	DisKaynakKullanimi	Dış kaynak kullanımı
11	KurumsalYonetim	Kurumsal yönetim
12	RiskYonetimi	Risk yönetimi
13	OdemeSistemleri	Ödeme sistemleri
14	AcikBankacilik	Açık bankacılık (Open Banking)
15	KriptoDijitalVarliklar	Kripto & dijital varlıklar (eskiden Kripto)
16	VergiMevzuati	Vergi mevzuatı (eskiden Vergi)
17	MuhasebeStandartlari	Muhasebe standartları (eskiden Muhasebe)
18	Denetim	Denetim
19	RekabetHukuku	Rekabet hukuku (eskiden Rekabet)
20	ESGSurdurulebilirFinans	ESG & sürdürülebilir finans
21	YaptirimlarUlkeRiski	Yaptırımlar & ülke riski
22	OperasyonelDayaniklilik	Operasyonel dayanıklılık (DORA-eşdeğeri)
23	PiyasaButunlugu	Piyasa bütünlüğü
24	IstihdamIsHukuku	İstihdam & iş hukuku
25	FintechDijitalFinansYZ	Fintech, dijital finans & yapay zekâ

---

ObligationActionType — Yükümlülük Aksiyon Tipi

Yükümlülüğün doğasındaki temel aksiyon. İstek filtrelerinde enum ismi olarak gönderilir (?actionTypes=Report); yanıtlarda sayı döner.

ID	Enum İsmi	Açıklama
0	Other	Yukarıdakilerin hiçbirine tam uymayan
1	Report	Bildirim/raporlama (regülatöre veya iç organa)
2	Implement	Süreç/sistem kurma veya değiştirme
3	Prohibit	Belirli bir davranışın yasaklanması
4	Document	Belgeleme / evrak tutma yükümlülüğü
5	FileRecord	Sicil veya kayıt tutma
6	Train	Personel eğitimi
7	UpdatePolicy	Politika veya sözleşme güncelleme
8	NotifyCustomer	Müşteriye yönelik bildirim

---

ObligationSeverity — Ciddiyet

Yükümlülüğün regülatif risk düzeyi. İstekte enum ismi (?severityMin=High); yanıtta sayı.

ID	Enum İsmi	Açıklama
1	Low	Bilgilendirici, ihlal halinde önemli yaptırım yok
2	Medium	Standart denetim bulgusu seviyesinde
3	High	Para cezası veya operasyonel kısıtlama riski
4	Critical	Lisans iptali, faaliyet durdurma veya yüksek miktarlı ceza riski

severityMin parametresi bu seviyede ve üzerini filtreler — severityMin=High hem High hem Critical döner.

---

DeadlineKind — Son Tarih Türü

Yanıtta deadlineKind alanı bu enum'un sayı değerini taşır. Filtreleme için doğrudan parametre yok; tarih aralığı için deadlineAfter / deadlineBefore, son tarihi olan-olmayan ayrımı için hasDeadline=true|false kullanın.

ID	Enum İsmi	Açıklama
0	None	Son tarih belirtilmemiş
1	Explicit	Mevzuatta kesin tarih (örn. "31.12.2026 tarihine kadar")
2	Relative	Bir olaya göreli süre (örn. "yayım tarihinden 90 gün sonra")
3	Conditional	Tetikleyici olaya bağlı (örn. "şüpheli işlem tespitinde")
4	Unclear	Mevzuatta geçiyor ama net değil (AI açıkladı, insan teyidi bekleniyor)

---

DocumentFormat — Doküman Formatı

Kaynak dokümanın orijinal formatı. Yalnızca yanıtta görünür.

ID	Enum İsmi	Açıklama
0	Html	HTML sayfa (örn. Resmi Gazete web fihristi)
1	Pdf	PDF dosyası
2	Image	Tek görsel (taranmış belge — OCR gerekmiş)
3	Mixed	Karma format (HTML + gömülü PDF/görsel)

---

Pratik İpuçları

• Çoklu değer: obligations/search parametreleri (institutionTypes, departments, topics, actionTypes) dizi alır. Aynı parametreyi tekrar edin: ?topics=1&topics=8&topics=22.
• Etkin tag arayan istekler: Etiket filtreleri tam eşleşme çalışır — bir yükümlülüğün bir tag setinde herhangi bir değer eşleşmesi yeterlidir (OR mantığı). Departman ve konu enum ID'lerini birleştirerek geniş ağ atın.
• TumFinansalKuruluslar (ID 20) özel bir wildcard'dır: bu etikete sahip yükümlülükler tüm InstitutionType filtrelerine yanıt verir. Subscription profili tarafından otomatik eşleştirme için kullanılır.
• Geçersiz değerler sessizce atlanır: ?institutionTypes=999 istekte 400 dönmez; sadece eşleşen sonuç olmaz. ?actionTypes=NotARealValue aynı şekilde — filtre yokmuş gibi davranır.