Dokümanlar / Uç Noktalar

Bilgi Kütüphanesi Değişiklik Geçmişi

GET /api/v1/informative-library/{id}/changes

Bu sayfada

Bilgi Kütüphanesi Değişiklik Geçmişi
Parametre
Yanıt
Bu uç nokta döndürmez
İçerik değişikliği takibi kaynak bazında açılır
Yetki

Bilgi Kütüphanesi Değişiklik Geçmişi

Bir kurum, yayımladığı duyuruyu aynı adreste yerinde güncellediğinde ne değiştiğini döner: en son revizyonun farkı (diff) ve revizyon zaman çizelgesi.

Bunu Sürüm Serisi ile karıştırmayın: seri, birbirini izleyen ayrı belgelerdir; revizyon ise tek bir belgenin içeriğinin değişmesidir.

Parametre

id — kayıt ID'si (browse yanıtındaki id).

Yanıt

documentId — sorduğunuz kaydın ID'si
latestRevisionNumber — en son revizyon numarası; hiç revizyon yoksa null
detectedAt — en son değişikliğin tespit edildiği an
previousTitle / newTitle — başlık da değiştiyse eski ve yeni başlık
latestDiff[] — en son revizyonun düz (birleşik) farkı: her satır type + text
oldLines[] / newLines[] — yan yana görünüm için satır satır hizalanmış iki pano; oldLines[i] ile newLines[i] eşleşir. Bu panolardaki satırlar type + text'e ek olarak kendi tarafındaki 1 tabanlı lineNumber alanını da taşır (hizalama dolgusu olan satırlarda null)
truncated — fark çok uzun olduğu için kesildiyse true
revisions[] — tüm revizyonlar (yeniden eskiye): revisionNumber, detectedAt, titleChanged, previousTitle, newTitle

Satır type değerleri: unchanged, inserted, deleted, modified ve panoları hizalamak için kullanılan boş dolgu satırı imaginary. modified satırlarda kelime düzeyinde vurgulama için segments[] (text + changed) bulunabilir; diğer satır türlerinde bu alan boştur.

Bu uç nokta `404` döndürmez

Kaydın hiç revizyonu yoksa — ki normal durum budur — yanıt yine 200 ve aynı zarftır: latestRevisionNumber null, diziler boş. Bilinmeyen bir ID için de aynı boş zarf döner, 404 gelmez. Bu nedenle bir kaydın var olup olmadığını bu uç noktayla sınamayın; Bilgi Kütüphanesi Detayı uç noktası bunun için 404 döndürür.

İçerik değişikliği takibi kaynak bazında açılır

Yerinde güncelleme tespiti her kaynak için varsayılan olarak kapalıdır ve kaynak bazında açılır. Takibi açık olmayan bir kaynağın kayıtları, kurum belgeyi gerçekten güncellemiş olsa bile boş zarf döndürür. Ayrıca takip açıldıktan sonraki ilk gözlem yalnızca referans noktasını oluşturur; değişiklik olarak sayılmaz.

Yetki

Api.InformativeLibrary.Detail iznini gerektirir ve detay uç noktasıyla aynı kota kovasından düşer. Ayrı bir izin tanımlanması gerekmez.

Parametreler

İsim	Konum	Tip	Zorunlu	Açıklama
`id`	Path	`uuid`	Evet	Kayıt ID'si.

Yanıtlar

200 — documentId, latestRevisionNumber, truncated, latestDiff[], oldLines[], newLines[], detectedAt, previousTitle, newTitle, revisions[]. Revizyon yoksa (veya ID bilinmiyorsa) aynı zarf boş alanlarla döner — bu uç nokta 404 döndürmez.

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

curl -X GET \
  "https://api.regvion.com/api/v1/informative-library/7a3f9e2c-4b8d-11ef-8a3c-0242ac120002/changes" \
  -H "X-API-Key: rgv_live_REPLACE_WITH_YOUR_KEY"

const url = 'https://api.regvion.com/api/v1/informative-library/7a3f9e2c-4b8d-11ef-8a3c-0242ac120002/changes';
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/7a3f9e2c-4b8d-11ef-8a3c-0242ac120002/changes"
headers = {"X-API-Key": "rgv_live_REPLACE_WITH_YOUR_KEY"}
response = requests.get(url, headers=headers)
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/7a3f9e2c-4b8d-11ef-8a3c-0242ac120002/changes");
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/7a3f9e2c-4b8d-11ef-8a3c-0242ac120002/changes', $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/7a3f9e2c-4b8d-11ef-8a3c-0242ac120002/changes"))
    .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/7a3f9e2c-4b8d-11ef-8a3c-0242ac120002/changes", 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/7a3f9e2c-4b8d-11ef-8a3c-0242ac120002/changes')
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/7a3f9e2c-4b8d-11ef-8a3c-0242ac120002/changes")
    .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/7a3f9e2c-4b8d-11ef-8a3c-0242ac120002/changes")!)
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/7a3f9e2c-4b8d-11ef-8a3c-0242ac120002/changes")
        .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/7a3f9e2c-4b8d-11ef-8a3c-0242ac120002/changes' -Method Get -Headers $headers

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

Bilgi Kütüphanesi Değişiklik Geçmişi

Parametre

Yanıt

Bu uç nokta 404 döndürmez

İçerik değişikliği takibi kaynak bazında açılır

Yetki

Parametreler

Yanıtlar

200 — documentId, latestRevisionNumber, truncated, latestDiff[], oldLines[], newLines[], detectedAt, previousTitle, newTitle, revisions[]. Revizyon yoksa (veya ID bilinmiyorsa) aynı zarf boş alanlarla döner — bu uç nokta 404 döndürmez.

Bu uç nokta `404` döndürmez