Dokümanlar / Uç Noktalar

Ne Değişti (Sürüm Farkı)

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

Bu sayfada

Ne Değişti (Sürüm Farkı)
Parametre
Yanıt
Paketlerde dosya bazında fark:
Boş yanıt hata değildir
30 dakikalık önbellek
Aynı şema Bilgi Kütüphanesinde de geçerlidir
Yetki ve kota

Ne Değişti (Sürüm Farkı)

Bir regülasyonun metni kaynağında yerinde güncellendiğinde, önceki metinle yeni metin arasındaki farkı ve revizyon geçmişini döner.

Parametre

id — regülasyon doküman ID'si (/library yanıtındaki id).

Yanıt

documentId — sorgulanan belge.
latestRevisionNumber — en son uygulanmış revizyonun sıra numarası.
truncated — fark, boyut sınırına takılıp kısaltıldıysa true.
latestDiff[] — düz (birleşik) fark; her satır type ve text taşır.
oldLines[] / newLines[] — yan yana gösterim için satır satır hizalanmış iki pano. oldLines[i] ile newLines[i] aynı satıra karşılık gelir.
detectedAt, previousTitle, newTitle — son revizyonun başlık bilgisi.
revisions[] — tüm revizyon geçmişi: revisionNumber, detectedAt, titleChanged, previousTitle, newTitle.
files[] — yalnız zip paketlerinde: son revizyonun dosya bazında farkı (aşağıda). Paket olmayan belgede ve dosya farkı kaydedilmemiş eski revizyonlarda null (boş dizi değil).
note — son revizyonun Türkçe notu ya da null. Doluysa değişiklik duyurulmuş ama yeni içerik okunamamıştır (örneğin kaynağın yayımladığı yeni paket boyut sınırını aştı); gösterilen içerik önceki sürümdür. Bu durumda latestDiff, oldLines ve newLines boş, files null gelir — istemci fark yerine notu göstermelidir.

Paketlerde dosya bazında fark: `files[]`

Paketin değişmeyen dosyaları listede yoktur; paketin içindekiler listesi farka girmez. Her öğe:

path — dosyanın paket içindeki yolu.
change — değişikliğin türü:
- added — dosya pakete eklendi.
- removed — dosya paketten çıkarıldı.
- changed — dosyanın metni değişti; metni karşılaştırılamayan bir dosyada (tablo, görüntü, metni olmayan dosya) dosyanın kendisi değişti.
- unreadable — dosya pakette duruyor ama artık okunamıyor (bozuk, şifreli ya da bir sınır nedeniyle işlenmedi). Okunamaz olan dosya hiçbir zaman removed gösterilmez.
contentComparable — true: lines[] dosyanın metninin farkıdır. false: dosyanın karşılaştırılan bir metni yoktur; öğe yalnız dosyanın adını ve değişikliğin türünü söyler, lines[] boştur.
lines[] — fark satırları, latestDiff ile aynı şema.
truncated — dosyanın farkı satır sınırında kısaltıldıysa true.

Fark satırlarındaki type değerleri: unchanged, inserted, deleted, modified ve imaginary. imaginary yalnızca iki panoyu satır satır hizalamak için eklenen dolgu satırıdır — lineNumber alanı null'dır ve ekranda içerik olarak gösterilmemelidir. modified satırlarında kelime düzeyinde vurgulama için segments dizisi de dolabilir.

latestDiff geriye dönük uyumluluk için korunur; yeni istemciler yan yana panoları kullanabilir.

Boş yanıt hata değildir

İçerik değişikliği takibi yalnızca bunun açık olduğu kaynaklarda çalışır. Takibin kapalı olduğu bir kaynakta veya belgenin hiç revizyonu yoksa uç nokta boş listelerle 200 döner. 404 yalnızca belge yoksa veya boru hattı tamamlanmamışsa gelir.

30 dakikalık önbellek

Yanıt sunucu tarafında 30 dakika önbelleklenir.

Aynı şema Bilgi Kütüphanesinde de geçerlidir

GET /api/v1/informative-library/{id}/changes tamamen aynı yanıt şemasını döner; aynı istemci görüntüleyicisini iki külliyat için de kullanabilirsiniz.

Yetki ve kota

Api.Library.Detail iznini gerektirir ve detay uç noktasıyla aynı kota kovasından düşer.

Parametreler

İsim	Konum	Tip	Zorunlu	Açıklama
`id`	Path	`uuid`	Evet	Regülasyon doküman ID'si.

Yanıtlar

200 — documentId, latestRevisionNumber, truncated, düz birleşik fark latestDiff[], yan yana panolar oldLines[]/newLines[], detectedAt, previousTitle, newTitle ve revisions[]. Hiç revizyonu olmayan belge boş listelerle 200 döner (hata değil). Yanıt 30 dakika önbelleklenir. Zip paketlerinde ayrıca files[] (dosya bazında fark: path, change — added | removed | changed | unreadable —, contentComparable, lines[], truncated); paket olmayan belgede ve dosya farkı olmayan revizyonda null. note: son revizyonun Türkçe notu ya da null — doluysa değişiklik duyuruldu ama yeni içerik okunamadı (örn. yeni paket boyut sınırını aştı), gösterilen içerik önceki sürümdür; latestDiff/oldLines/newLines boş, files null gelir.

404 — Regülasyon bulunamadı.

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

curl -X GET \
  "https://api.regvion.com/api/v1/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/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/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/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/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/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/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/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/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/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/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/library/7a3f9e2c-4b8d-11ef-8a3c-0242ac120002/changes' -Method Get -Headers $headers

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

Ne Değişti (Sürüm Farkı)

Parametre

Yanıt

Paketlerde dosya bazında fark: files[]

Boş yanıt hata değildir

30 dakikalık önbellek

Aynı şema Bilgi Kütüphanesinde de geçerlidir

Yetki ve kota

Parametreler

Yanıtlar

404 — Regülasyon bulunamadı.

Paketlerde dosya bazında fark: `files[]`