Dokümanlar / Uç Noktalar

Bilgi Kütüphanesi Sürüm Serisi

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

Bu sayfada

Bilgi Kütüphanesi Sürüm Serisi
Parametre
Yanıt
bir hata değildir
Yetki

Bilgi Kütüphanesi Sürüm Serisi

Bazı duyurular düzenli olarak yinelenir (örn. aynı başlıklı dönemsel talep çağrıları, periyodik listeler). Bu uç nokta, bir kaydın ait olduğu ailenin nüshalarını en yeniden eskiye doğru döner.

Seri, aynı belgenin güncellenmiş hâli değildir: her nüsha kendi başına ayrı bir belgedir ve hiçbiri diğerini yürürlükten kaldırmaz. Bir belgenin yerinde güncellenmesi ayrı bir kavramdır; onun için Değişiklik Geçmişi uç noktasına bakın.

Parametre

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

Yanıt

seriesId — serinin kimliği
title — serinin müşteriye görünen adı
memberCount — ailedeki toplam nüsha sayısı
firstPublishedDate / lastPublishedDate — serinin ilk ve son nüshasının yayın tarihi
currentId — sorduğunuz kayıt; zaman çizelgesini bu kayda göre konumlandırabilirsiniz
members[] — nüshalar: id, title, publishedDate, isCurrent

members en fazla 500 nüsha taşır. memberCount bu sınırdan bağımsız gerçek toplamı bildirir, dolayısıyla dönen üye sayısından büyük olabilir.

`data: null` bir hata değildir

Kayıt herhangi bir seriye ait değilse veya serisi henüz yönetici onayından geçmemişse yanıt 200 ve data: null döner. Bu iki durum istemci açısından bilerek ayırt edilemez — onaylanmamış bir gruplama müşteriye hiç var olmamış gibi görünür. null gelmesini "kayıt yok" olarak değil, "gösterilecek seri yok" olarak yorumlayın.

404 — verilen ID ile kayıt bulunamadı.

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 — seriesId, title, memberCount, firstPublishedDate, lastPublishedDate, currentId ve members[] (en fazla 500 nüsha). Kayıt bir seriye ait değilse veya serisi henüz onaylanmamışsa 'data' null döner.

404 — Kayıt bulunamadı.

⚠️ 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/series" \
  -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/series';
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/series"
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/series");
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/series', $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/series"))
    .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/series", 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/series')
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/series")
    .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/series")!)
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/series")
        .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/series' -Method Get -Headers $headers

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

Bilgi Kütüphanesi Sürüm Serisi

Parametre

Yanıt

data: null bir hata değildir

Yetki

Parametreler

Yanıtlar

200 — seriesId, title, memberCount, firstPublishedDate, lastPublishedDate, currentId ve members[] (en fazla 500 nüsha). Kayıt bir seriye ait değilse veya serisi henüz onaylanmamışsa 'data' null döner.

404 — Kayıt bulunamadı.

`data: null` bir hata değildir