Dokümanlar / Uç Noktalar

Mevzuat Nüshaları

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

Bu sayfada

Mevzuat Nüshaları
Parametre
Yanıt
Yürürlük süzgeci uygulanmaz
Yetki ve kota

Mevzuat Nüshaları

Aynı kanunun farklı kaynaklardaki diğer nüshalarını döner.

Aynı kanun, kütüphanede kaynak başına ayrı bir belge olarak durur (Mevzuat Bilgi Sistemi'ndeki nüsha, kurumun kendi sitesindeki nüsha, vb.). Kütüphane listesi bu aileyi tek satıra topladığı için — kartta yalnızca sourceCount rozeti görünür — ailenin diğer üyelerine ulaşmanın tek yolu bu uç noktadır.

Parametre

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

Yanıt

groupTitle — ailenin ortak başlığı.
regulationNumber — kanun numarası (örn. 5411).
memberCount — ailedeki toplam nüsha sayısı (baktığınız belge dâhil). Belgenin ailesi yoksa groupTitle ve regulationNumber null, memberCount 0 döner.
viewedIsRepresentative — baktığınız nüsha, kütüphane listesinde görünen nüsha mı. İstemci doğru başlığı bununla kurar: temsilciye bakarken liste "diğer kaynaklar", bir kurum nüshasına bakarken listedeki temsilci "asıl nüsha"dır.
members[] — her üye için id, title, sourceId, sourceName, publishedDate, legalStatus ("Yürürlükte" | "Değişmiş" | "Mülga") ve isRepresentative.

İki davranış özellikle önemli:

members baktığınız belgeyi içermez — yalnızca diğer nüshaları listeler.
Boş members listesi "bu belge tek nüshalıdır" demektir, hata değil. 404 yalnızca belge hiç yoksa (veya boru hattı tamamlanmamışsa) döner; istemci bu ikisini ayırt edebilsin diye gruplu olmayan belge boş listeyle 200 alır.

Yürürlük süzgeci uygulanmaz

/library uç noktasının aksine bu uç yürürlük süzgeci uygulamaz: ailenin mülga üyeleri de listelenir. Amaç kasıtlıdır — bir kanunun eski/mülga nüshasını görmek isteyen kullanıcı tam da buraya bakar.

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 — groupTitle, regulationNumber, memberCount, viewedIsRepresentative ve members[] (id, title, sourceId, sourceName, publishedDate, legalStatus, isRepresentative). members bakılan belgeyi İÇERMEZ; boş members = tek nüshalı belge (hata değil). Bu uç yürürlük süzgeci uygulamaz — mülga üyeler de listelenir.

404 — Belge 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/versions" \
  -H "X-API-Key: rgv_live_REPLACE_WITH_YOUR_KEY"

const url = 'https://api.regvion.com/api/v1/library/7a3f9e2c-4b8d-11ef-8a3c-0242ac120002/versions';
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/versions"
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/versions");
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/versions', $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/versions"))
    .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/versions", 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/versions')
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/versions")
    .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/versions")!)
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/versions")
        .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/versions' -Method Get -Headers $headers

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