Emsal Anlamlı Arama
/api/v1/court-decisions/semantic
Emsal karar külliyatında doğal dille arama yapar. Anahtar kelime eşleşmesi yerine anlam benzerliği kullanılır; "işverenin haklı nedenle fesih hakkını hangi sürede kullanması gerekir" gibi günlük dilde ifadelere yanıt verir.
Parametreler
search— zorunlu. Boş veya yalnızca boşluk ise400 VALIDATION_ERRORdöner.page— sayfa numarası (varsayılan 1).pageSize— 1-50 arası (varsayılan 12). 50'nin üzerindeki değerler sessizce 50'ye kırpılır.
pageSize varsayılanı ve üst sınırı, Emsal Kararlar listeleme uç noktasından farklıdır (orada 1-100, varsayılan 20).
Sorgunun türü sonucu belirler
Sorgu, türüne göre farklı biçimde yanıtlanır:
- Esas/karar numarası içeren sorgular (örn.
2022/7767 E.) numaraya göre aranır; sonuçlar karar tarihine göre yeniden eskiye sıralanır vematchedSnippetnulldöner. - Kanun numarası içeren sorgular (örn.
6100 sayılı), cümle hâlinde yazılmış olsalar bile metin eşleşmesiyle aranır; sonuçlar yine karar tarihine göre sıralanır,matchedSnippetdoludur. - Doğal dilde yazılmış diğer sorgular anlam benzerliğiyle aranır; sonuçlar alaka sırasına göre döner.
- Anlam benzerliği yeterince yakın sonuç vermediğinde yanıt sessizce metin eşleşmesi sonuçlarına döner.
Numaraya göre arama ve metin eşleşmesi yalnızca tam metni alınmış kararları (hasText = true) kapsar — bir kararın metni henüz alınmadıysa bu yollarla dönmez.
Yanıt — listelemeden farklı zarf
Bu uç nokta /api/v1/court-decisions ile aynı zarfı kullanmaz:
- Parça alanının adı
matchedSnippet'tir (listelemedekisnippetDEĞİL) ve yalnızca metin eşleşmesiyle bulunan isabetlerde doludur; anlam benzerliğiyle ya da esas/karar numarasıyla bulunanlardanull'dur. - Gövdenin kökünde
degradedbayrağı vardır:trueise arama bileşenlerinden biri geçici olarak yanıt veremedi ve sonuçlar kısmidir — eksiktir, hatta hiç sonuç dönmemiş olabilir.degraded: truegördüğünüzde sonuçları tam kapsamlı varsaymayın; isteği sonradan tekrarlamak genellikle işe yarar. pagination.totalCountIsLowerBoundher zamantrue'dur — sıralı bir aramada kesin toplam hesaplanmaz.totalCount, o sayfanın sonuna kadar bilinen isabet sayısıdır, külliyattaki eşleşme sayısı değildir.pagination.truncated—trueise sayfa, sıralamanın ilk 100 kaydı sınırında kesilmiştir.pagination.totalCountIsEstimatealanı bu uç noktada yoktur.
- sıradan sonrasını isteyen sayfalar (örn.
pageSize=12&page=10) boş birdatadizisi,totalCount: 0vetruncated: truedöner — bu sınırın ötesi alaka açısından anlamlı değildir, daha fazla sayfa istemenin anlamı yoktur.
Kayıt alanları
id, itemType + itemTypeLabel, birimAdi, esasNo, kararNo, kararTuru, kesinlesmeDurumu, kararTarihi + kararTarihiStr, textStatus + textStatusLabel, hasText, matchedSnippet. Tam metin (plainText) bu uç noktadan dönmez; bunun için Emsal Karar Detayı uç noktasını kullanın.
Yetki ve kota
Api.CourtDecisions.Browse iznini gerektirir — ayrı bir izin yoktur ve paketinize ek bir tanım yapılması gerekmez. Emsal listeleme ile aynı hız ve aylık kota kovasını tüketir.
Kredi bitince
Bu uç yapay zekâ kredisi kullanır. Kredi bittiğinde 402 CREDITS_EXHAUSTED döner; anahtar kelime uçları krediden bağımsızdır, aramanızı oradan sürdürebilirsiniz.
Parametreler
| İsim | Konum | Tip | Zorunlu | Açıklama |
|---|---|---|---|---|
search |
Query | string |
Evet | Arama cümlesi. Boş bırakılamaz; boş veya yalnızca boşluk ise 400 VALIDATION_ERROR döner. |
page |
Query | integer |
Hayır | Sayfa numarası. |
pageSize |
Query | integer |
Hayır | 1-50; varsayılan 12. Aşan değerler sessizce 50'ye kırpılır. |