Dokümanlar / Uç Noktalar

Mevzuat Bülteni (Dönem Özeti)

GET /api/v1/library/digest

Bu sayfada

Mevzuat Bülteni (Dönem Özeti)
Zorunlu tarih penceresi
Diğer parametreler
Yanıt
Yürürlük süzgeci
Yetki ve kota

Mevzuat Bülteni (Dönem Özeti)

Belirli bir tarih penceresinde yayımlanan regülasyonların özet listesini tek çağrıda döner. Kendi bülteninizi, haftalık raporunuzu veya "bu ay ne çıktı" ekranınızı beslemek için tasarlanmıştır — sayfa sayfa /library gezmeye gerek kalmaz.

Zorunlu tarih penceresi

publishedSince — pencere başlangıcı (ISO 8601). Zorunlu.
publishedUntil — pencere bitişi (ISO 8601). Zorunlu. Bitiş günü tümüyle dâhildir.

İkisinden biri eksikse veya tarih olarak ayrıştırılamıyorsa uç nokta 400 VALIDATION_ERROR döner.

Pencereye iki düzeltme uygulanır ve ikisi de hata vermez, sessizce çalışır:

Ters pencere takas edilir. publishedUntil publishedSince'ten önceyse iki uç yer değiştirir.
Pencere en fazla 366 gündür. Daha genişini isterseniz başlangıç kırpılır: publishedUntil'dan geriye 366 gün alınır. Yani çok geniş bir aralık gönderdiğinizde eksik veri değil, beklediğinizden dar bir pencere alırsınız.

Diğer parametreler

institutionType — virgülle ayrılmış InstitutionType sayı değerleri, örn. 1,4. (Gezinme ucundaki tekil sayı davranışından farklıdır.)
topic — virgülle ayrılmış TopicType sayı değerleri, örn. 3,9.
maxResults — 1-500 arasına kırpılır; varsayılan 200.

Ayrıştırılamayan bir sayı listeden sessizce düşer.

Yanıt

windowStart / windowEnd — yukarıdaki düzeltmeler uygulandıktan sonra fiilen kullanılan pencere. Gönderdiğiniz değerlerden farklı olabilir; ekranda tarih aralığı gösteriyorsanız bu iki alanı kullanın.
totalCount — penceredeki toplam kayıt sayısı (maxResults'tan bağımsız).
truncated — toplam sonuç maxResults'ı aşıyorsa true. Bu durumda pencereyi daraltın veya maxResults'ı yükseltin.
items[] — her kayıt: id, title, publishedDate, sourceUrl, sourceName, sourceShortCode, summary ve institutionTypes (okunabilir etiketler).

Kayıtlar yayım tarihine göre yeniden eskiye sıralı döner. sourceName / sourceShortCode alanları /library gezinme yanıtında yoktur — bu uç noktaya özeldir, ayrıca bir id→ad haritası kurmanız gerekmez.

Yürürlük süzgeci

Bülten yalnızca yürürlükteki mevzuatı içerir; mülga belgeler hiçbir koşulda dönmez ve bunu kapatan bir parametre yoktur. Mülga mevzuata erişmek için GET /library?legalStatus=all kullanın.

Yetki ve kota

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

Parametreler

İsim	Konum	Tip	Zorunlu	Açıklama
`publishedSince`	Query	`date-time`	Evet	Pencere başlangıcı (ISO 8601). Zorunlu.
`publishedUntil`	Query	`date-time`	Evet	Pencere bitişi (ISO 8601). Zorunlu; bitiş günü tümüyle dâhildir.
`institutionType`	Query	`string`	Hayır	Virgülle ayrılmış InstitutionType sayı değerleri, örn. '1,4'. (Gezinme ucundaki tekil sayı davranışından farklıdır.)
`topic`	Query	`string`	Hayır	Virgülle ayrılmış TopicType sayı değerleri, örn. '3,9'.
`maxResults`	Query	`integer`	Hayır	1-500 arasına kırpılır; varsayılan 200.

Yanıtlar

200 — windowStart, windowEnd, totalCount, truncated ve items[] (id, title, publishedDate, sourceUrl, sourceName, sourceShortCode, summary, institutionTypes). Pencere 366 günle sınırlıdır (aşılırsa publishedUntil'dan geriye 366 gün alınır); publishedUntil < publishedSince ise iki uç yer değiştirir. Mülga mevzuat bu uçtan hiçbir zaman dönmez.

400 — publishedSince/publishedUntil eksik veya ayrıştırılamadı (VALIDATION_ERROR).

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

curl -X GET \
  "https://api.regvion.com/api/v1/library/digest?publishedSince=2026-07-01T00:00:00Z&publishedUntil=2026-07-31T23:59:59Z" \
  -H "X-API-Key: rgv_live_REPLACE_WITH_YOUR_KEY"

const url = 'https://api.regvion.com/api/v1/library/digest?publishedSince=2026-07-01T00:00:00Z&publishedUntil=2026-07-31T23:59:59Z';
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/digest"
headers = {"X-API-Key": "rgv_live_REPLACE_WITH_YOUR_KEY"}
params = {"publishedSince": "2026-07-01T00:00:00Z", "publishedUntil": "2026-07-31T23:59:59Z", "institutionType": "1,4", "topic": "3,9", "maxResults": "200"}
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/library/digest?publishedSince=2026-07-01T00:00:00Z&publishedUntil=2026-07-31T23:59:59Z");
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/digest?publishedSince=2026-07-01T00:00:00Z&publishedUntil=2026-07-31T23:59:59Z', $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/digest?publishedSince=2026-07-01T00:00:00Z&publishedUntil=2026-07-31T23:59:59Z"))
    .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/digest?publishedSince=2026-07-01T00:00:00Z&publishedUntil=2026-07-31T23:59:59Z", 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/digest?publishedSince=2026-07-01T00:00:00Z&publishedUntil=2026-07-31T23:59:59Z')
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/digest?publishedSince=2026-07-01T00:00:00Z&publishedUntil=2026-07-31T23:59:59Z")
    .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/digest?publishedSince=2026-07-01T00:00:00Z&publishedUntil=2026-07-31T23:59:59Z")!)
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/digest?publishedSince=2026-07-01T00:00:00Z&publishedUntil=2026-07-31T23:59:59Z")
        .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/digest?publishedSince=2026-07-01T00:00:00Z&publishedUntil=2026-07-31T23:59:59Z' -Method Get -Headers $headers

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