Dokümanlar / Uç Noktalar

Bilgi Kütüphanesi

GET /api/v1/informative-library

Bu sayfada

Bilgi Kütüphanesi
Arama ve filtreleme
Yanıt
Sayfalama
Yetki ve kota

Bilgi Kütüphanesi

Düzenleyici kurumların bilgilendirici duyuru ve kararlarını (örn. Rekabet Kurumu tefhim duyuruları, TBMM kanun teklifleri) listeler. Mevzuat Kütüphanesinden ayrıdır: orijinal belge saklanır, okunabilir metni çıkarılır ve kayıt yapay zeka ile zenginleştirilir — özet, kategori ve konu etiketleri üretilir, kayıt vektör aramasına açılır. Mevzuat Kütüphanesindeki gibi bir yükümlülük çıkarımı yapılmaz; kurum/departman/konu enum etiketleri de bu külliyatta yoktur.

Zenginleştirme her kayıt için geriye dönük çalıştırılmaz: bir kaynağın ilk (tohumlama) taramasında gelen kayıtlar ile metni çok kısa olan kayıtlar işlenmez. Bu nedenle summary, aiCategory ve topics alanları null olabilir — bu bir hata değildir, kaydın henüz/hiç işlenmediği anlamına gelir.

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

Arama ve filtreleme

q — başlık ve belge metninde tam metin araması (Postgres FTS, Türkçe; aksandan bağımsız). En az 3 karakterlik sorgularda başlık üzerinde ayrıca substring eşleşmesi denenir.
sourceId — belirli bir kaynağa göre filtre. Kaynak listesi için Bilgi Kütüphanesi Kaynakları.
category — kaynak içi bölüm/kategori (örn. Tefhim Duyuruları). Tam eşleşme arar, substring değil.
dateFrom / dateTo — yayın tarihi aralığı (yyyy-MM-dd veya dd.MM.yyyy; bitiş günü dahil).
sort — date_desc | date_asc | title_asc | title_desc. q verildiğinde varsayılan ilgi (relevance) sıralaması, verilmediğinde date_desc'tir.
groupBySeries — true ise yinelenen duyuru aileleri (seriler) tek satırda toplanır ve her aile en yeni nüshasıyla temsil edilir. Seriye ait olmayan kayıt tek üyeli bir aile gibi davranır. Varsayılan false. Toplama, ailenin yönetici onayından geçip geçmediğine bakmaz: onaylanmamış bir aile de tek satıra iner, ancak aşağıdaki rozet alanları boş kalır.

Yanıt

Her kayıt: id, sourceId, title, publishedDate, category, format (bkz. Enum Referansı — DocumentFormat), hasText, hasFile ve q verildiğinde eşleşen metin parçası (snippet).

Yapay zeka alanları: summary (Türkçe özet), aiCategory (atanan kategori adı), topics (konu etiketi dizisi) — işlenmemiş kayıtlarda null.

Seri rozeti: seriesId, seriesTitle, seriesCount. Bu üçü yalnızca kaydın serisi yönetici onayından geçmişse dolar; onaylanmamış bir gruplama rozet olarak hiç görünmez. Serinin tüm nüshaları için Sürüm Serisi uç noktasına bakın.

snippet, kaydın çıkarılmış metni üzerinden üretilir — eşleşme yalnızca başlıktan geldiyse veya kaydın metni yoksa boş dönebilir.

Sayfalama

page (varsayılan 1) ve pageSize (1-100, varsayılan 20; aralık dışı değerler sessizce kırpılır).

Toplam sayı 10.000'de sınırlandırılır: gerçek toplam bunu aşarsa pagination.totalCount 10.000 döner ve pagination.totalCountIsLowerBound true olur. Sayfa sayısını hesaplarken bu bayrağı kontrol edin.

Yetki ve kota

Api.InformativeLibrary.Browse iznini gerektirir; paket bazında ayrı hız/kota limitlerine tabidir.

Parametreler

İsim	Konum	Tip	Zorunlu	Açıklama
`q`	Query	`string`	Hayır	Başlık + belge metninde tam metin (FTS) araması.
`sourceId`	Query	`uuid`	Hayır	Kaynağa göre filtre (bkz. /informative-library/sources).
`category`	Query	`string`	Hayır	Kaynak içi bölüm/kategori filtresi (örn. 'Tefhim Duyuruları').
`dateFrom`	Query	`string`	Hayır	Yayın tarihi başlangıç (yyyy-MM-dd veya dd.MM.yyyy).
`dateTo`	Query	`string`	Hayır	Yayın tarihi bitiş (gün dahil).
`sort`	Query	`string`	Hayır	'date_desc' \| 'date_asc' \| 'title_asc' \| 'title_desc'; q verildiğinde varsayılan ilgi sıralaması, verilmediğinde 'date_desc'.
`groupBySeries`	Query	`boolean`	Hayır	true ise yinelenen duyuru aileleri (seriler) tek satırda toplanır; her aile en yeni nüshasıyla temsil edilir.
`page`	Query	`integer`	Hayır	Sayfa numarası.
`pageSize`	Query	`integer`	Hayır	1-100; varsayılan 20. Aralık dışı değerler sessizce kırpılır.

Yanıtlar

200 — Kayıtların sayfalı listesi: id, sourceId, title, publishedDate, category, format, hasText, hasFile, snippet, yapay zeka alanları (summary, aiCategory, topics) ve seri rozeti (seriesId, seriesTitle, seriesCount). Toplam sayı 10.000'de sınırlandırılır; aşıldığında 'pagination.totalCountIsLowerBound' true döner.

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

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

const url = 'https://api.regvion.com/api/v1/informative-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/informative-library"
headers = {"X-API-Key": "rgv_live_REPLACE_WITH_YOUR_KEY"}
params = {"q": "value", "sourceId": "value", "category": "value", "dateFrom": "value", "dateTo": "value", "sort": "value", "groupBySeries": "false", "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/informative-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/informative-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/informative-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/informative-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/informative-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/informative-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/informative-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/informative-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/informative-library' -Method Get -Headers $headers

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