Dokümanlar / Uç Noktalar

Emsal Anlamlı Arama

GET /api/v1/court-decisions/semantic

Bu sayfada

Emsal Anlamlı Arama
Parametreler
Sorgu, cevaplayabilecek kola yönlendirilir
Yanıt — listelemeden farklı zarf
Kayıt alanları
Yetki ve kota
Kredi bitince

Emsal Anlamlı Arama

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

Sorgu, cevaplayabilecek kola yönlendirilir

Sorgu tek bir yöntemle değil, sorgunun türüne göre seçilen bir kolla yanıtlanır:

Esas/karar numarası içeren sorgular (örn. 2022/7767 E.) yapısal arama koluna gider; 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 anahtar kelime (tam metin) koluna gider; sonuçlar yine karar tarihine göre sıralanır, matchedSnippet bu koldan gelir.
Doğal dilde yazılmış diğer sorgular vektör (anlam) koluna gider; sonuçlar alaka sırasına göre döner.
Anlam kolunun güven eşiğinin altında kaldığı durumlarda yanıt sessizce anahtar kelime koluna düşer.

Anahtar kelime ve yapısal kollar, yalnızca tam metni alınmış kararları (hasText = true) kapsar — bir kararın metni henüz alınmadıysa bu kollardan 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 anahtar kelime kolundan gelen isabetlerde doludur; anlam kolundan ve yapısal koldan gelenlerde null'dur.
Gövdenin kökünde degraded bayrağı vardır: true ise kollardan biri yanıt veremedi ve sonuçlar ayakta kalan kolla üretildi — 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ı (top-K) sınırında kesilmiştir.
pagination.totalCountIsEstimate alanı bu uç noktada yoktur.

sıradan sonrasını isteyen sayfalar (örn. pageSize=12&page=10) boş bir data dizisi, totalCount: 0 ve truncated: true döner — sıralı bir aramada bu sınırın ötesi gürültüdür, 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.

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

⚠️ Sunucudan sunucuya — API anahtarınızı tarayıcıda paylaşmayın. Neden?

curl -X GET \
  "https://api.regvion.com/api/v1/court-decisions/semantic?search=işverenin haklı nedenle fesih hakkını kullanma süresi" \
  -H "X-API-Key: rgv_live_REPLACE_WITH_YOUR_KEY"

const url = 'https://api.regvion.com/api/v1/court-decisions/semantic?search=işverenin haklı nedenle fesih hakkını kullanma süresi';
const headers = {
  'X-API-Key': 'rgv_live_REPLACE_WITH_YOUR_KEY'
};

const response = await fetch(url, {
  method: 'GET',
  headers,
});

if (!response.ok) throw new Error(`HTTP ${response.status}`);
const body = await response.json();
console.log(body.data);
console.log('Request ID:', body.meta.requestId);

import requests

url = "https://api.regvion.com/api/v1/court-decisions/semantic"
headers = {"X-API-Key": "rgv_live_REPLACE_WITH_YOUR_KEY"}
params = {"search": "işverenin haklı nedenle fesih hakkını kullanma süresi", "page": "1", "pageSize": "12"}
response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
body = response.json()
print(body["data"])
print("Request ID:", body["meta"]["requestId"])

using System.Net.Http;
using System.Net.Http.Json;
using System.Text;
using System.Text.Json;

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-Key", "rgv_live_REPLACE_WITH_YOUR_KEY");

var response = await client.GetAsync("https://api.regvion.com/api/v1/court-decisions/semantic?search=işverenin haklı nedenle fesih hakkını kullanma süresi");
response.EnsureSuccessStatusCode();
var body = await response.Content.ReadFromJsonAsync<JsonElement>();
Console.WriteLine(body.GetProperty("meta").GetProperty("requestId").GetString());

<?php
require 'vendor/autoload.php';

$client = new GuzzleHttp\Client();

$options = [
    'headers' => [
        'X-API-Key' => 'rgv_live_REPLACE_WITH_YOUR_KEY',
    ],
];

$response = $client->request('GET', 'https://api.regvion.com/api/v1/court-decisions/semantic?search=işverenin haklı nedenle fesih hakkını kullanma süresi', $options);
$body = json_decode($response->getBody(), true);
echo 'Request ID: ' . $body['meta']['requestId'];

import java.net.URI;
import java.net.http.*;
import java.net.http.HttpRequest.BodyPublishers;

HttpClient client = HttpClient.newHttpClient();

HttpRequest.Builder b = HttpRequest.newBuilder()
    .uri(URI.create("https://api.regvion.com/api/v1/court-decisions/semantic?search=işverenin haklı nedenle fesih hakkını kullanma süresi"))
    .header("X-API-Key", "rgv_live_REPLACE_WITH_YOUR_KEY")
    .GET();

HttpResponse<String> response = client.send(b.build(), HttpResponse.BodyHandlers.ofString());
System.out.println("Status: " + response.statusCode());
System.out.println(response.body());

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://api.regvion.com/api/v1/court-decisions/semantic?search=işverenin haklı nedenle fesih hakkını kullanma süresi", nil)
    req.Header.Set("X-API-Key", "rgv_live_REPLACE_WITH_YOUR_KEY")

    resp, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer resp.Body.Close()

    var envelope struct {
        Data interface{} `json:"data"`
        Meta struct { RequestId string `json:"requestId"` } `json:"meta"`
    }
    json.NewDecoder(resp.Body).Decode(&envelope)
    fmt.Println("Request ID:", envelope.Meta.RequestId)
}

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.regvion.com/api/v1/court-decisions/semantic?search=işverenin haklı nedenle fesih hakkını kullanma süresi')
request = Net::HTTP::Get.new(uri)
request['X-API-Key'] = 'rgv_live_REPLACE_WITH_YOUR_KEY'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

body = JSON.parse(response.body)
puts "Request ID: #{body['meta']['requestId']}"

import okhttp3.*
import okhttp3.MediaType.Companion.toMediaType
import okhttp3.RequestBody.Companion.toRequestBody

val client = OkHttpClient()

val builder = Request.Builder()
    .url("https://api.regvion.com/api/v1/court-decisions/semantic?search=işverenin haklı nedenle fesih hakkını kullanma süresi")
    .addHeader("X-API-Key", "rgv_live_REPLACE_WITH_YOUR_KEY")

client.newCall(builder.build()).execute().use { response ->
    println("Status: ${'$'}{response.code}")
    println(response.body?.string())
}

import Foundation

var request = URLRequest(url: URL(string: "https://api.regvion.com/api/v1/court-decisions/semantic?search=işverenin haklı nedenle fesih hakkını kullanma süresi")!)
request.httpMethod = "GET"
request.setValue("rgv_live_REPLACE_WITH_YOUR_KEY", forHTTPHeaderField: "X-API-Key")

let (data, response) = try await URLSession.shared.data(for: request)
if let http = response as? HTTPURLResponse { print("Status: \(http.statusCode)") }
print(String(data: data, encoding: .utf8) ?? "")

use reqwest::blocking::Client;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();
    let mut req = client.get("https://api.regvion.com/api/v1/court-decisions/semantic?search=işverenin haklı nedenle fesih hakkını kullanma süresi")
        .header("X-API-Key", "rgv_live_REPLACE_WITH_YOUR_KEY")
        ;
    let res = req.send()?;
    println!("Status: {}", res.status());
    println!("{}", res.text()?);
    Ok(())
}

$headers = @{
    'X-API-Key' = 'rgv_live_REPLACE_WITH_YOUR_KEY'
}

$response = Invoke-RestMethod -Uri 'https://api.regvion.com/api/v1/court-decisions/semantic?search=işverenin haklı nedenle fesih hakkını kullanma süresi' -Method Get -Headers $headers

$response.data
Write-Host "Request ID:" $response.meta.requestId