Dokümanlar / Uç Noktalar

Mevzuat Anlamlı Arama

GET /api/v1/library/semantic

Bu sayfada

Mevzuat Anlamlı Arama
Hibrit boru hattı
Filtreler tercih sinyalidir
Hata ve hata ayıklama
Sayfalama ve top-K sınırı
ile karşılaştırma
Paketler: ve

Mevzuat Anlamlı Arama

Cümle veya soru bazlı, niyet temelli mevzuat aramasıdır. Anahtar kelime eşleşmesi yerine vektör benzerliği + tam metin füzyonu kullanır; bu nedenle "müşteri şikayetlerinin yönetim süreci" gibi günlük dilde ifadelere doğal yanıt verir.

Hibrit boru hattı

Sorgu, çok dilli Qwen3-Embedding-8B modeliyle 4096 boyutlu vektöre çevrilir (sorgu tarafında modelin instruct ön-eki uygulanır)
Qdrant (vektör) + Postgres FTS (anahtar kelime) paralel olarak çalışır — her biri top-K = max(50, take*3) döner
Sonuçlar RRF (Reciprocal Rank Fusion, k=60) ile birleştirilir
Re-ranking: başlıkta sorgu kelimesi geçen sonuçlara +0.05, aktif filtreyle eşleşen etiket başına +0.10 ek puan eklenir

Filtreler tercih sinyalidir

institutionType, topic, department parametreleri eleme yapmaz — sadece sıralamada öne çekme/aşağı itme sinyali olarak kullanılır. Yani filtreyle eşleşmeyen sonuçlar yine listelenir, daha alta düşer. Bu davranış, anlamlı arama sonuçlarının çok dar bir filtre yüzünden tamamen kaybolmasını engeller.

/library (anahtar kelime) ile farkını burada vurgulamak gerek: orada filtreler sert filtredir; burada yumuşak sinyaldir.

Ancak bu yumuşaklık yalnızca institutionType / topic / department için geçerlidir. Uç nokta, geri getirmeden sonra iki sert eleme uygular: mülga mevzuatı koşulsuz eler (/library'deki legalStatus=all karşılığı burada yoktur) ve aynı kanunun farklı kaynaklardaki nüshalarını tek satıra indirir. Bu nedenle bir sayfa pageSize'dan az sonuç içerebilir; pagination.totalCount eleme öncesi sayıdır.

Hata ve hata ayıklama

search parametresi boş veya eksik gönderilirse uç nokta 400 VALIDATION_ERROR döner.

İsteğe X-Regvion-Debug-Search: 1 başlığını eklerseniz her sonuç ayrıca bir debug nesnesi taşır: semantic, keyword, titleBoost, tagBoost ve rrfRank. Başlık gönderilmezse bu alan null döner.

Sayfalama ve top-K sınırı

pageSize 1-50 arası (varsayılan 12)
Toplam top-K = 100 ile sınırlıdır; bunun ötesi sıralama gürültüsüdür
pagination.truncated = true döndüğünde, sınır aşıldığı için daha fazla sayfa istemenin manası yoktur

`/library` ile karşılaştırma

Özellik	`/library` (anahtar kelime)	`/library/semantic` (anlamlı)
Sorgu yapısı	Token bazlı	Cümle/soru bazlı
Filtre davranışı	Sert (eler)	Etiket filtreleri yumuşak (sinyal); mülga elemesi ve nüsha daraltması serttir
Eşleşme	Postgres FTS (Türkçe kök + aksan duyarsız) + başlıkta ILIKE yedeği	Vektör benzerliği + FTS füzyonu (RRF)
`pageSize` üst sınırı	100	50
Sıralama	`sort` ile seçilir: `date_desc` / `date_asc` / `title_asc` / `title_desc` / `relevance`	Sabit — relevance
Snippet	`<b>` highlight, FTS headline	`<b>` highlight, kelime tabanlı
`obligationCount`	Gerçek yükümlülük sayısı	Her zaman `0` — bu uçta doldurulmaz; sayı için `/library/{id}/obligations`

Listeleme veya filtreleme önceliğiniz varsa /library'yi, doğal dille soru sorduğunuzda /library/semantic'i tercih edin.

Aynı mevzuatın ikinci resmî nüshası (ikiz) listelerde ve sayımlarda yer almaz; detay ucu canonicalDocumentId ile sahibine işaret eder.

Paketler: `isPackage` ve `matchedFile`

Sonuçlar /library ile aynı paket alanlarını taşır: isPackage (sonuç bir zip paketi mi) ve matchedFile (sorgu sözcüklerinin hepsinin geçtiği tek paket dosyasının yolu; yoksa null). Kurallar için Mevzuat Kütüphanesi sayfasına bakın. Doğal dilde yazılmış uzun sorgularda bütün sözcüklerin tek bir dosyada geçmesi seyrek olduğundan matchedFile burada çoğunlukla null'dır.

Parametreler

İsim	Konum	Tip	Zorunlu	Açıklama
`search`	Query	`string`	Evet	Arama cümlesi.
`institutionType`	Query	`integer`	Hayır	Tercih sinyali — InstitutionType enum sayı değeri (1-24). Sonuçları dışlamaz, yeniden sıralar.
`topic`	Query	`integer`	Hayır	Tercih sinyali — TopicType enum sayı değeri (1-25).
`department`	Query	`integer`	Hayır	Tercih sinyali — DepartmentType enum sayı değeri (1-24).
`page`	Query	`integer`	Hayır	Sayfa numarası.
`pageSize`	Query	`integer`	Hayır	1-50; varsayılan 12.
`X-Regvion-Debug-Search`	Header	`string`	Hayır	'1' gönderildiğinde her sonuca skor kırılımı eklenir: debug = { semantic, keyword, titleBoost, tagBoost, rrfRank }. Gönderilmezse bu alan null döner.

Yanıtlar

200 — Anlamlı arama sonuçları (top-K=100); pagination.truncated=true ise sınır aşılmıştır. Mülga mevzuat ve aynı kanunun diğer nüshaları geri getirmeden sonra elendiği için bir sayfa pageSize'dan az sonuç içerebilir; pagination.totalCount eleme öncesi sayıdır. 'X-Regvion-Debug-Search: 1' gönderildiyse her sonuç ayrıca debug skor kırılımını taşır.

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

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

curl -X GET \
  "https://api.regvion.com/api/v1/library/semantic?search=müşteri şikayetlerinin yönetim süreci" \
  -H "X-API-Key: rgv_live_REPLACE_WITH_YOUR_KEY"

const url = 'https://api.regvion.com/api/v1/library/semantic?search=müşteri şikayetlerinin yönetim süreci';
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/library/semantic"
headers = {"X-API-Key": "rgv_live_REPLACE_WITH_YOUR_KEY"}
params = {"search": "müşteri şikayetlerinin yönetim süreci", "institutionType": "value", "topic": "value", "department": "value", "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/library/semantic?search=müşteri şikayetlerinin yönetim süreci");
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/library/semantic?search=müşteri şikayetlerinin yönetim süreci', $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/library/semantic?search=müşteri şikayetlerinin yönetim süreci"))
    .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/library/semantic?search=müşteri şikayetlerinin yönetim süreci", 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/library/semantic?search=müşteri şikayetlerinin yönetim süreci')
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/library/semantic?search=müşteri şikayetlerinin yönetim süreci")
    .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/library/semantic?search=müşteri şikayetlerinin yönetim süreci")!)
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/library/semantic?search=müşteri şikayetlerinin yönetim süreci")
        .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/library/semantic?search=müşteri şikayetlerinin yönetim süreci' -Method Get -Headers $headers

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

Mevzuat Anlamlı Arama

Hibrit boru hattı

Filtreler tercih sinyalidir

Hata ve hata ayıklama

Sayfalama ve top-K sınırı

/library ile karşılaştırma

Paketler: isPackage ve matchedFile

Parametreler

Yanıtlar

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

`/library` ile karşılaştırma

Paketler: `isPackage` ve `matchedFile`