Enum Referansı
- Enum Referansı
- Hızlı Tablo — Hangi Enum, Nasıl Gönderilir, Nasıl Döner
- InstitutionType — Kurum Tipleri
- DepartmentType — Departmanlar
- TopicType — Konular
- ObligationActionType — Yükümlülük Aksiyon Tipi
- ObligationSeverity — Ciddiyet
- DeadlineKind — Son Tarih Türü
- DocumentFormat — Doküman Formatı
- CaseLawItemType — Emsal Karar Külliyatı
- CaseLawTextStatus — Emsal Karar Metin Durumu
- Pratik İpuçları
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ı — ancak /library/{id} ve /library/{id}/obligations içinde enum ismi string'i, değer atanmamışsa null |
DeadlineKind |
(filtre yok) | sayı |
DocumentFormat |
(filtre yok) | sayı |
(*) İstisna:
/libraryuçlarının tamamı (/library,/library/semantic,/library/{id}ve/library/digest) etiket dizilerini insan-okunabilir Türkçe etiket string'i olarak döner (örn.["Banka", "Ödeme Kuruluşu"]), sayı dizisi olarak değil;/library/digestbunlardan yalnızcainstitutionTypesalanını taşır. Sayı dizisi dönen uçlar:/obligations/{id}üç etiket dizisini de (institutionTypeIds,departmentIds,topicIds),/obligations/search,/obligations/upcoming,/documents/{id}ve/documents/{id}/obligationsyalnızcadepartmentIds'i,/subscriptions/profileiseinstitutionTypes/topicsalanlarını döndürür./library/{id}/obligationshiç etiket dizisi döndürmez — bu uç noktanın yükümlülük nesnesindeinstitutionTypes/departments/topicsalanları yoktur; etiket kimlikleri gerekiyorsa yükümlülüğünid'si ile/obligations/{id}'ye gidin./library/{id}ve/library/{id}/obligationsuçlarındaseverityalanı da sayı değil, enum ismi string'idir.
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 |
| 22 | KalkinmaVeYatirimBankasi |
Kalkınma ve yatırım bankaları (5411 sayılı Kanun md. 3) |
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) |
CaseLawItemType — Emsal Karar Külliyatı
Emsal karar uç noktalarında (/court-decisions, /court-decisions/{id}, /court-decisions/semantic) kararın hangi külliyattan geldiğini belirtir. /court-decisions üzerinde itemType sorgu parametresi olarak sayı değeriyle gönderilir.
Tanımsız bir sayı gönderirseniz istek hata vermez — filtre sessizce uygulanmaz ve tüm külliyatlar döner. Değeri göndermeden önce bu tablodan doğrulayın.
Yanıtta hem sayı (itemType) hem de Türkçe etiketi (itemTypeLabel) birlikte döner.
| ID | Enum İsmi | itemTypeLabel |
|---|---|---|
| 0 | YargitayKarari |
Yargıtay |
| 1 | DanistayKarar |
Danıştay |
| 2 | YerelHukuk |
Yerel Hukuk Mahkemesi |
| 3 | IstinafHukuk |
İstinaf Hukuk Dairesi |
| 4 | Kyb |
Kanun Yararına Bozma |
| 5 | Uyusmazlik |
Uyuşmazlık Mahkemesi |
| 6 | Anayasa |
Anayasa Mahkemesi |
| 7 | Aihm |
AİHM |
CaseLawTextStatus — Emsal Karar Metin Durumu
Kararın tam metninin (Tam Metin) alınıp alınmadığını gösterir. Yalnızca yanıtta görünür; filtre parametresi yoktur. Yanıtta sayı (textStatus), Türkçe etiket (textStatusLabel) ve pratik kullanım için hasText boolean alanı birlikte döner — hasText, yalnızca textStatus = 1 olduğunda true'dur.
| ID | Enum İsmi | textStatusLabel |
Açıklama |
|---|---|---|---|
| 0 | Pending |
Özet | Yapılandırılmış künye var; tam metin henüz alınmadı |
| 1 | Fetched |
Tam Metin | Tam metin mevcut (hasText: true) |
| 2 | Failed |
Alınamadı | Kaynaktan alınamadı (yeniden deneme bütçesi tükendi) |
| 3 | Skipped |
Atlandı | Bilinçli olarak atlandı (metne dönüştürülemeyen içerik) |
Pratik İpuçları
- Çoklu değer:
obligations/searchparametreleri (institutionTypes,departments,topics,actionTypes) dizi alır. Aynı parametreyi tekrar edin:?topics=1&topics=8&topics=22. - Kütüphane uçlarında parametre adları farklıdır: yukarıdaki tablodaki çoğul adlar yalnızca
obligations/searchiçindir./libraryve/library/semanticher etiket türü için tekil ve tek değerli parametre alır (?institutionType=1&topic=8&department=3) — bu uçlarda çoklu değer desteklenmez./library/digestise virgülle ayrılmış liste bekler (?institutionType=1,20). - 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) sektör geneli bir wildcard etiketidir ve abonelik/bülten eşleştirmesinde otomatik olarak her kurum tipine uyar. API filtrelerinde (
/obligations/search?institutionTypes=…) wildcard genişletmesi yapılmaz — yatay düzenlemeleri de görmek istiyorsanız20'yi filtre değerlerinize açıkça ekleyin:?institutionTypes=1&institutionTypes=20. - Sayı tabanlı etiket filtrelerinde geçersiz değer sessizce atlanır:
?institutionTypes=999istekte 400 dönmez; sadece eşleşen sonuç olmaz. Aynısıdepartmentsvetopicsiçin de geçerlidir. actionTypesböyle DEĞİLDİR: tanınmayan bir enum ismi (?actionTypes=NotARealValue) filtreyi yok saymaz, isteğin tamamını500/INTERNAL_ERRORile düşürür. Yalnızca yukarıdaki tabloda listelenen enum isimlerini gönderin:Other,Report,Implement,Prohibit,Document,FileRecord,Train,UpdatePolicy,NotifyCustomer.severityMiniçin tanınmayan bir değer yok sayılır — filtre hiç uygulanmaz, yani beklediğinizden geniş bir sonuç kümesi dönebilir.