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

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.

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

Parametreler

Yanıtlar

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

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