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
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.

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.

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