İçeriğe Geç

Emsal Anlamlı Arama

GET /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 ise 400 VALIDATION_ERROR dö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 ve matchedSnippet null dö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, matchedSnippet doludur.
  • 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 (listelemedeki snippet DEĞİL) ve yalnızca metin eşleşmesiyle bulunan isabetlerde doludur; anlam benzerliğiyle ya da esas/karar numarasıyla bulunanlarda null'dur.
  • Gövdenin kökünde degraded bayrağı vardır: true ise arama bileşenlerinden biri geçici olarak yanıt veremedi ve sonuçlar kısmidir — eksiktir, hatta hiç sonuç dönmemiş olabilir. degraded: true gördüğünüzde sonuçları tam kapsamlı varsaymayın; isteği sonradan tekrarlamak genellikle işe yarar.
  • pagination.totalCountIsLowerBound her zaman true'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 — true ise sayfa, sıralamanın ilk 100 kaydı sınırında kesilmiştir.
  • pagination.totalCountIsEstimate alanı bu uç noktada yoktur.
  1. sıradan sonrasını isteyen sayfalar (örn. pageSize=12&page=10) boş bir data dizisi, totalCount: 0 ve truncated: true dö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

İsimKonumTipZorunluAçı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.

Yanıtlar

200 — Sıralanmış kararlar. Yanıt zarfı listeleme uç noktasından FARKLIDIR: gövdenin kökünde 'degraded' bayrağı vardır, 'pagination' içinde 'truncated' ve her zaman true olan 'totalCountIsLowerBound' bulunur, parça alanının adı 'snippet' değil 'matchedSnippet'tir.

400 — 'search' parametresi verilmedi veya boş (VALIDATION_ERROR).