Dokümanlar / Uç Noktalar

Bilgi Kütüphanesi Belge İndirme

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

Bu sayfada

Bilgi Kütüphanesi Belge İndirme
Parametre
Yanıt
Yetki

Bilgi Kütüphanesi Belge İndirme

Kaydın kaydedilmiş orijinal dosyasını (genellikle PDF) indirir.

Parametre

id — kayıt ID'si. Yalnızca hasFile true olan kayıtlarda dosya bulunur.

Yanıt

Dosya akışı; Content-Type kaydedilmiş dosya türünden gelir (çoğunlukla application/pdf; kaydedilmiş bir tür yoksa format alanından türetilir). Kaydedilmiş bir tür varsa bu, listeleme ve detay yanıtlarındaki contentType alanıyla aynı MIME türüdür (HTML dosyalarda charset parametresi aşağıda anlatıldığı gibi düzeltilebilir). format alanı Pdf olsa bile dosya eski bir Office veya arşiv dosyası olabilir (örn. application/msword); dosya adının uzantısı da buna göre verilir. HTML dosyalarda charset, dosyanın kendi bildirimini yineler: kodlama bildirmeyen geçerli UTF-8 dosyalara <meta charset="utf-8" /> eklenir, bayt içeriği UTF-8 olduğu halde eski bir kod sayfası bildiren dosyalarda bildirim utf-8 olarak düzeltilir; kaynak sunucunun kaydedilmiş türü yalnızca hiçbir şey bildirmeyen ve UTF-8 olmayan dosyalar için kullanılır. Dosya adı kaydın başlığından üretilir. Yanıt Cache-Control: public, max-age=86400 taşır — belge 24 saat boyunca istemci/ara katman önbelleğinden servis edilebilir.

404 — kayıt bulunamadı, kayda bağlı bir dosya yok (hasFile false), ya da dosya depoda bulunamadı. Üç durum aynı yanıtı döner.

Yetki

Api.InformativeLibrary.Download iznini gerektirir.

Parametreler

İsim	Konum	Tip	Zorunlu	Açıklama
`id`	Path	`uuid`	Evet	Kayıt ID'si.

Yanıtlar

200 — Dosya akışı (Content-Type kaynağa göre, genellikle application/pdf; HTML için `charset` dosyanın kendi bildirimini yineler).

404 — Kayıt veya dosya 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/download" \
  -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/download';
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/download"
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/download");
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/download', $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/download"))
    .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/download", 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/download')
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/download")
    .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/download")!)
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/download")
        .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/download' -Method Get -Headers $headers

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