Dokümanlar / Uç Noktalar

Bilgi Kütüphanesi Anlamlı Arama

GET /api/v1/informative-library/semantic

Bu sayfada

Bilgi Kütüphanesi Anlamlı Arama
Parametreler
Yanıt
Top-K sınırı ve daraltılmış zarf
Kesintide davranış
Yetki ve kota

Bilgi Kütüphanesi Anlamlı Arama

Bilgi Kütüphanesinde doğal dille arama yapar. Sorgu bir vektöre çevrilip anlam araması ile tam metin (FTS) araması paralel çalıştırılır, iki sıralı liste RRF (Reciprocal Rank Fusion, k=60) ile birleştirilir. Bu nedenle günlük dilde yazılmış ifadeler, birebir kelime geçmese de sonuç döndürebilir.

Sıralamada başlık veya etiket ek puanı yoktur; sıralamayı yalnızca füzyon belirler.

Parametreler

search — zorunlu. Boş veya yalnızca boşluk ise 400 VALIDATION_ERROR döner.
page — sayfa numarası (varsayılan 1).
pageSize — 1-50 arası (varsayılan 12). 50'nin üzerindeki değerler sessizce 50'ye kırpılır.

pageSize varsayılanı ve üst sınırı, Bilgi Kütüphanesi listeleme uç noktasından farklıdır (orada 1-100, varsayılan 20). Bu uç nokta sourceId, category veya tarih süzgeci kabul etmez; filtrelemeniz gerekiyorsa listeleme uç noktasını kullanın.

Yanıt

Her kayıt: id, sourceId, title, publishedDate, category, format, hasText, matchedSnippet ve yapay zeka alanları summary / aiCategory / topics.

Parça alanının adı matchedSnippet'tir (listelemedeki snippet DEĞİL). Kayıt tam metin kolundan geldiyse <b> vurgulu bir pasaj, yalnızca anlam kolundan geldiyse en iyi eşleşen metin parçasının ilk 200 karakteri döner.
hasFile, plainText, attributes ve seri rozeti alanları bu uç noktadan dönmez; bunlar için Bilgi Kütüphanesi Detayı uç noktasını kullanın.
totalCount, birleştirilmiş aday kümesinin büyüklüğüdür (en fazla 100) — külliyattaki eşleşme sayısı değildir. Bu sayıyı toplam sonuç sayısı olarak yorumlamayın.

Top-K sınırı ve daraltılmış zarf

Sıralama ilk 100 kayıtta (top-K) kesilir; bunun ötesi sıralama gürültüsüdür.

Birleştirilmiş sonuç kümesi 100'ü aşarsa yanıt daraltılmış bir zarfa geçer ve standart zarftan iki noktada ayrılır:

pagination yalnızca totalCount, page, pageSize ve truncated alanlarını taşır — totalCountIsLowerBound ve totalCountIsEstimate bu zarfta yoktur.
meta alanı (requestId dahil) gönderilmez.

sıradan sonrasını isteyen sayfalar (örn. pageSize=12&page=10) aynı daraltılmış zarfı boş bir data dizisi, totalCount: 0 ve truncated: true ile döner. truncated gördüğünüzde daha fazla sayfa istemeyin; sorguyu daraltın.

Kesintide davranış

Anlam kolu (sorgu vektörleştirme veya vektör araması) yanıt veremezse istek hata döndürmez — sonuçlar sessizce yalnızca tam metin arama koluyla üretilir. Bu uç noktada bunu bildiren bir bayrak yoktur (emsal karşılığındaki degraded alanının muadili burada bulunmaz).

Yetki ve kota

Api.InformativeLibrary.Browse iznini gerektirir — ayrı bir izin yoktur ve paketinize ek bir tanım yapılması gerekmez. Bilgi Kütüphanesi listeleme ile aynı hız ve aylık kota kovasını tüketir.

Parametreler

İsim	Konum	Tip	Zorunlu	Açıklama
`search`	Query	`string`	Evet	Arama cümlesi. Boş bırakılamaz; boş veya yalnızca boşluk ise 400 VALIDATION_ERROR döner.
`page`	Query	`integer`	Hayır	Sayfa numarası.
`pageSize`	Query	`integer`	Hayır	1-50; varsayılan 12. Aşan değerler sessizce 50'ye kırpılır.

Yanıtlar

200 — Alaka sırasına göre sıralanmış kayıtlar; parça alanının adı 'snippet' değil 'matchedSnippet'tir. Sıralama top-K = 100'de kesilirse yanıt DARALTILMIŞ zarfa geçer: 'pagination' yalnızca totalCount/page/pageSize/truncated taşır ve 'meta' alanı gönderilmez.

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

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

curl -X GET \
  "https://api.regvion.com/api/v1/informative-library/semantic?search=elektrik piyasası kapasite tahsisi duyurusu" \
  -H "X-API-Key: rgv_live_REPLACE_WITH_YOUR_KEY"

const url = 'https://api.regvion.com/api/v1/informative-library/semantic?search=elektrik piyasası kapasite tahsisi duyurusu';
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/semantic"
headers = {"X-API-Key": "rgv_live_REPLACE_WITH_YOUR_KEY"}
params = {"search": "elektrik piyasası kapasite tahsisi duyurusu", "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/informative-library/semantic?search=elektrik piyasası kapasite tahsisi duyurusu");
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/semantic?search=elektrik piyasası kapasite tahsisi duyurusu', $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/semantic?search=elektrik piyasası kapasite tahsisi duyurusu"))
    .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/semantic?search=elektrik piyasası kapasite tahsisi duyurusu", 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/semantic?search=elektrik piyasası kapasite tahsisi duyurusu')
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/semantic?search=elektrik piyasası kapasite tahsisi duyurusu")
    .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/semantic?search=elektrik piyasası kapasite tahsisi duyurusu")!)
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/semantic?search=elektrik piyasası kapasite tahsisi duyurusu")
        .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/semantic?search=elektrik piyasası kapasite tahsisi duyurusu' -Method Get -Headers $headers

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