Dokümanlar / Uç Noktalar

Mevzuat Kütüphanesi

GET /api/v1/library

Bu sayfada

Mevzuat Kütüphanesi
Filtreleme
Aynı kanunun nüshaları tek satırda toplanır
ile fark
Paketler: ve

Mevzuat Kütüphanesi

/documents uç noktasının etiketlenmiş versiyonudur. AI, boru hattında her regülasyonu kurum tipi (InstitutionType) ve konu (TopicType) etiketleriyle işaretler. Bu uç nokta bu etiketler ile filtreleme sunar.

Filtreleme

institutionType — kurum tipinin sayı değeri (1-22). Tam liste: Enum Referansı.
topic — konunun sayı değeri (1-25).
department — departmanın sayı değeri (1-24).
search — başlık, AI özeti/sınıflandırması ve yükümlülük metinleri üzerinde Postgres tam metin araması (Türkçe kök ve aksan duyarsız) + başlıkta ≥3 karakterlik alt dize yedeği. Eşleşen kayıtlarda matchedSnippet alanı <b> ile işaretli pasajı döner. Belgenin çıkarılmış ham metni bu indekse dâhil değildir; gövde metninde arama için /library/semantic kullanın. /documents?filter= ile de aynı değildir — orası kök/aksan farkındalığı, pasajı ve skoru olmayan düz bir LIKE filtresidir (yalnızca başlık + AI özeti).
sort — kabul edilen değerler: date_desc, date_asc, title_asc, title_desc, relevance. relevance yalnızca search ile birlikte anlamlıdır. Varsayılan: search varsa ilgi düzeyi, yoksa date_desc. Listede olmayan bir ifade (örn. publishedDate desc) hata vermez ama yok sayılır; aramasız gezinmede sonuçlar bu durumda yayım tarihine değil kayıt oluşturma tarihine göre sıralanır.
legalStatus — yürürlük süzgeci: all (tüm korpus, mülga dâhil) veya mulga (yalnızca mülga). Belirtilmezse mülga mevzuat yanıttan çıkarılır — hem sonuçlardan hem pagination.totalCount sayısından. "Değişmiş" (değiştirilmiş ama hâlâ yürürlükte) belgeler varsayılan sonuçlara dâhildir. Tanınmayan bir değer hata vermez, sessizce varsayılana döner; tam korpusu görmenin tek yolu ?legalStatus=all'dır.

Aynı kanunun nüshaları tek satırda toplanır

Bir kanunun farklı kaynaklardaki (örn. Mevzuat Bilgi Sistemi + kurum sitesi) kopyaları listede tek satırda gösterilir. Karttaki sourceCount alanı ailenin büyüklüğüdür (1 ise tek nüshalı belgedir), ailenin diğer üyelerine ise yalnızca GET /library/{id}/versions ile ulaşılır.

`/documents` ile fark

Uç nokta	Etiket filtresi	Yanıt alanları
`/documents`	Yok	Başlık, kaynak adı, format, URL
`/library`	Var (kurum + konu)	Başlık, kaynak id'si (ad değil — `/library/sources` ile eşleyin), format, URL, özet, etiketler, yükümlülük sayısı, eşleşme pasajı (`matchedSnippet`), nüsha sayısı (`sourceCount`), yürürlük etiketi (`legalStatus`)

Kütüphane uç noktası özellikle compliance panel entegrasyonu için tasarlanmıştır. Düz kronolojik listeleme için /documents daha hafiftir.

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`

isPackage — sonuç bir zip paketi mi. Paketin dosyaları GET /library/{id} yanıtındaki files[]'tadır.
matchedFile — yalnız search gönderildiğinde ve yalnız paketlerde: arama sözcüklerinin hepsinin geçtiği tek dosyanın paket içindeki yolu (ekranda son bölümünü, yani dosya adını gösterin). Sözcükler dosyanın adında ya da metninde aranır; büyük/küçük harf ve Türkçe harf farkı gözetilmez, 3 harften kısa sözcükler, tırnaklar, -hariç ve or dikkate alınmaz, en çok 5 sözcük kullanılır. Sözcükler hiçbir dosyada ya da birden çok dosyada geçiyorsa null'dır. matchedSnippet pasajı belgenin başlığından ve özetinden gelir; matchedFile o pasajın değil, arama sözcüklerinin hangi dosyada olduğunu gösterir.

Parametreler

İsim	Konum	Tip	Zorunlu	Açıklama
`institutionType`	Query	`integer`	Hayır	Kurum tipi — InstitutionType enum sayı değeri (1-22). Tam liste: Enum Referansı sayfası.
`topic`	Query	`integer`	Hayır	Konu — TopicType enum sayı değeri (1-25).
`department`	Query	`integer`	Hayır	Departman — DepartmentType enum sayı değeri (1-24).
`search`	Query	`string`	Hayır	Serbest metin araması.
`source`	Query	`uuid`	Hayır	Yayımlayan kaynağa göre filtre (bkz. /library/sources).
`sort`	Query	`string`	Hayır	Sıralama: 'date_desc' \| 'date_asc' \| 'title_asc' \| 'title_desc' \| 'relevance'. 'relevance' yalnızca 'search' ile anlamlıdır. Varsayılan: 'search' verildiğinde ilgi düzeyi, verilmediğinde 'date_desc'. Bu beş değerin dışındaki bir ifade hata vermez; aramalı istekte yayım tarihine, aramasız gezinmede kayıt oluşturma tarihine göre sıralanır.
`legalStatus`	Query	`string`	Hayır	Yürürlük süzgeci: 'all' (tüm korpus, mülga dâhil) veya 'mulga' (yalnızca mülga). Belirtilmezse yalnızca yürürlükteki mevzuat döner — 'Değişmiş' (değiştirilmiş ama yürürlükte) belgeler dâhildir, 'Mülga' hariçtir. Tanınmayan bir değer hata vermez, sessizce bu varsayılana düşer.
`page`	Query	`integer`	Hayır	Sayfa numarası.
`pageSize`	Query	`integer`	Hayır	1-100; varsayılan 20.

Yanıtlar

200 — Etiketlenmiş regülasyonların sayfalı listesi. Her kayıt: id, sourceId (kaynak ADI değil), title, publishedDate, sourceUrl, documentFormat, summary, institutionTypes, departments, topics, obligationCount, matchedSnippet, sourceCount (aynı kanunun kaç kaynakta bulunduğu) ve legalStatus ('Yürürlükte' | 'Değişmiş' | 'Mülga'). Aynı kanunun farklı kaynaklardaki nüshaları tek satırda toplanır; diğer nüshalar için /library/{id}/versions.

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

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

const url = 'https://api.regvion.com/api/v1/library';
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"
headers = {"X-API-Key": "rgv_live_REPLACE_WITH_YOUR_KEY"}
params = {"institutionType": "1", "topic": "1", "department": "1", "search": "value", "source": "value", "sort": "date_desc", "legalStatus": "all", "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/library");
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', $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"))
    .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", 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')
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")
    .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")!)
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")
        .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' -Method Get -Headers $headers

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

Mevzuat Kütüphanesi

Filtreleme

Aynı kanunun nüshaları tek satırda toplanır

/documents ile fark

Paketler: isPackage ve matchedFile

Parametreler

Yanıtlar

`/documents` ile fark

Paketler: `isPackage` ve `matchedFile`