Dokümanlar / Uç Noktalar

Doküman İndir

GET /api/v1/documents/{id}/download

Bu sayfada

Doküman İndir
Dosya tipleri
Önbellekleme
Yaygın hatalar

Doküman İndir

Dokümanın orijinal dosyasını akış (streaming) olarak döner. Boyut disk'teki dosyaya eşittir ve bellekten geçmez. Dosya adı {güvenli başlık}.{uzantı} formatında Content-Disposition başlığı ile birlikte gelir.

Dosya tipleri

DocumentFormat.Pdf → application/pdf, .pdf
DocumentFormat.Html → text/html, .html
DocumentFormat.Image → image/png, .png
Diğer → application/octet-stream, .bin

Önbellekleme

Yanıt Cache-Control: public, max-age=86400 döner — 24 saat boyunca CDN ve tarayıcı tarafından önbelleklenebilir. Aynı doküman ID'si iki kez indirilirse ikinci çağrı proxy katmanından servislenecektir.

Yaygın hatalar

Doküman tamamlanmış olsa bile rawContentPath boşsa (scraping aşamasında dosya kaybolduysa) 404 döner. Kriz sonrası telafi için [email protected] adresine başvurun.
Bu çağrı oran sınırı için ayrı bir kategori altında sayılabilir (Api.Documents.Download tier izni). /account/usage buna ayrı alt kırılım sunmaz.

Parametreler

İsim	Konum	Tip	Zorunlu	Açıklama
`id`	Path	`uuid`	Evet	Doküman ID'si.

Yanıtlar

200 — Dosya akışı (Content-Type formata göre değişir).

404 — Doküman 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/documents/7a3f9e2c-4b8d-11ef-8a3c-0242ac120002/download" \
  -H "X-API-Key: rgv_live_REPLACE_WITH_YOUR_KEY"

const url = 'https://api.regvion.com/api/v1/documents/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/documents/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/documents/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/documents/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/documents/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/documents/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/documents/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/documents/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/documents/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/documents/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/documents/7a3f9e2c-4b8d-11ef-8a3c-0242ac120002/download' -Method Get -Headers $headers

$response.data
Write-Host "Request ID:" $response.meta.requestId