Dokümanlar / Uç Noktalar

Emsal Kararlar

GET /api/v1/court-decisions

Bu sayfada

Emsal Kararlar
Anahtar kelime araması
Toplam sayı sınırı ve iki bayrak
Filtreleme
Sayfalama
Yetki ve kota

Emsal Kararlar

UYAP/Adalet içtihat (emsal karar) külliyatında gezinmenizi ve anahtar kelimeyle arama yapmanızı sağlar. Bu külliyat, mevzuat kütüphanesinden ayrı tutulur: yapısal Detay alanları ve (alındıysa) tam metin saklanır. Mevzuat Kütüphanesindeki gibi bir yükümlülük/etiket çıkarımı uygulanmaz; yapay zeka analizi yalnızca seçilmiş kararlar için ayrıca çalıştırılır ve analiz çıktısı API üzerinden sunulmaz — detay yanıtındaki aiProcessed alanı yalnızca o karar için analiz çalıştırılıp çalıştırılmadığını bildirir.

Doğal dille (cümle/soru bazlı) arama için ayrı bir uç nokta vardır: Emsal Anlamlı Arama. Ek izin gerektirmez, bu sayfadaki izni kullanır.

Anahtar kelime araması

q — karar tam metni + daire adı üzerinde tam metin arama (Türkçe kök ve aksan duyarsız; örn. sozlesme sorgusu sözleşme geçen kararları bulur). Eşleşen kayıtlarda, eşleşen pasajı <b> işaretleriyle vurgulayan bir snippet alanı döner. Arama daire adı üzerinden de eşleşebildiği için, tam metni henüz alınmamış (hasText = false) kararlarda snippet null döner — bu alanı her zaman dolu varsaymayın.
Diğer tüm filtreler q ile VE mantığıyla birlikte çalışır.

Toplam sayı sınırı ve iki bayrak

Toplam sayı — hem anahtar kelime aramasında hem düz gezinmede — 10.000'de sınırlandırılır ve yanıt pagination içinde iki ek bayrak taşır:

totalCountIsLowerBound = true — totalCount tam olarak 10.000'dir, gerçek toplam bundan büyüktür. Hem q ile aramada hem düz gezinmede görülebilir.
totalCountIsEstimate = true — totalCount, Postgres planlayıcısının yaklaşık satır tahminidir; 10.000'in çok üzerinde olabilir ve kesin değildir. Yalnızca q verilmeden yapılan düz gezinmede görülür.

İki bayrak da false ise totalCount kesindir. Sayfa sayısını hesaplarken bayrakları kontrol edin.

Filtreleme

itemType — mahkeme/kurum türü (CaseLawItemType enum sayı değeri, 0-7; değer listesi için Enum Referansı sayfasına bakın). Tanımsız bir değer 400 döndürmez — süzgeci tamamen düşürür, yani sonuç filtrelenmemiş külliyattır.
department — daire / birim adı içinde geçen metin (örn. 12. Hukuk Dairesi).
esasNo / kararNo — esas ve karar numarası (örn. 2006/10799, 2006/13163).
dateFrom / dateTo — karar tarihi aralığı (yyyy-MM-dd veya dd.MM.yyyy; bitiş günü dahildir).
onlyWithText — true ise yalnızca tam metni alınmış kararlar.
sort — date_asc veya date_desc; verilmezse en yeni önce.

Sayfalama

page (varsayılan 1) ve pageSize (1-100, varsayılan 20; aralık dışı değerler sessizce kırpılır). Yanıt pagination ile toplam sayıyı ve yukarıdaki iki bayrağı döner.

Yetki ve kota

Bu uç nokta Api.CourtDecisions.Browse iznini gerektirir ve mevzuat Kütüphanesinden bağımsız olarak paket (tier) bazında hız/kota limitlerine tabidir.

Parametreler

İsim	Konum	Tip	Zorunlu	Açıklama
`q`	Query	`string`	Hayır	Anahtar kelime araması: karar tam metni + daire adı üzerinde tam metin arama (Türkçe kök/aksan duyarsız). Eşleşen kayıtlarda 'snippet' alanı döner; tam metni alınmamış (yalnızca daire adı üzerinden eşleşen) kararlarda 'snippet' null'dur.
`itemType`	Query	`integer`	Hayır	Mahkeme/kurum türü (CaseLawItemType enum sayı değeri, 0-7). Tam liste: Enum Referansı. Tanımsız bir değer hata döndürmez, süzgeci tamamen düşürür.
`department`	Query	`string`	Hayır	Daire / birim adı içinde geçen metin (örn. '12. Hukuk Dairesi').
`esasNo`	Query	`string`	Hayır	Esas numarası (örn. '2006/10799').
`kararNo`	Query	`string`	Hayır	Karar numarası (örn. '2006/13163').
`dateFrom`	Query	`string`	Hayır	Karar tarihi başlangıç (yyyy-MM-dd veya dd.MM.yyyy).
`dateTo`	Query	`string`	Hayır	Karar tarihi bitiş (gün dahil).
`onlyWithText`	Query	`boolean`	Hayır	Yalnızca tam metni alınmış kararlar.
`sort`	Query	`string`	Hayır	'date_asc' veya 'date_desc'; varsayılan en yeni.
`page`	Query	`integer`	Hayır	Sayfa numarası.
`pageSize`	Query	`integer`	Hayır	1-100; varsayılan 20.

Yanıtlar

200 — Kararların sayfalı listesi (daire, esas/karar no, tür, tarih, tam metin durumu; 'q' ile aramada eşleşme pasajı 'snippet'). Toplam sayı — hem anahtar kelime aramasında hem düz gezinmede — 10.000'de sınırlandırılır; yanıt 'pagination.totalCountIsLowerBound' veya (yalnızca düz gezinmede) 'pagination.totalCountIsEstimate' bayrağını taşıyabilir.

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

curl -X GET \
  "https://api.regvion.com/api/v1/court-decisions" \
  -H "X-API-Key: rgv_live_REPLACE_WITH_YOUR_KEY"

const url = 'https://api.regvion.com/api/v1/court-decisions';
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"
headers = {"X-API-Key": "rgv_live_REPLACE_WITH_YOUR_KEY"}
params = {"q": "value", "itemType": "value", "department": "value", "esasNo": "value", "kararNo": "value", "dateFrom": "value", "dateTo": "value", "onlyWithText": "false", "sort": "value", "page": "1", "pageSize": "20"}
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");
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', $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"))
    .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", 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')
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")
    .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")!)
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")
        .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' -Method Get -Headers $headers

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