Dokümanlar / Uç Noktalar

Dokümanları Listele

GET /api/v1/documents

Bu sayfada

Dokümanları Listele
Filtreleme
Sayfalama

Dokümanları Listele

Boru hattını tamamlamış (PipelineStatus = Completed) tüm dokümanları sayfalı olarak döner. Eksik, metin çıkarma aşamasında takılmış veya AI analizi bekleyen dokümanlar bu listede görünmez. Yanıt pagination zarfı ile birlikte gelir.

Filtreleme

filter parametresi başlıkta serbest metin araması yapar (sunucu tarafında ILIKE '%filter%'). Tam metin arama için /search/keyword veya /search/semantic uç noktalarını kullanın.

startDate ve endDate yayım tarihini (publishedDate) sınırlar. Her iki sınır dahildir ve ISO 8601 formatında beklenir. Saat dilimi eksikse UTC varsayılır.

sourceId parametresi /sources uç noktasından aldığınız kimliktir.

Sayfalama

page 1'den başlar — page=0 otomatik olarak 1'e yuvarlanır.
pageSize 1-100 arasıdır; 100'ün üstü 100'e kapanır. Varsayılan 20.
pagination.totalCount filtreli toplam kayıt sayısıdır; gerçek bir sayıdır (tahmin değil).

Her belgenin içerik gövdesi, AI özeti ve yükümlülükleri için /documents/{id} uç noktasını kullanın.

Parametreler

İsim	Konum	Tip	Zorunlu	Açıklama
`sourceId`	Query	`uuid`	Hayır	Belirli bir kaynakla sınırlandır.
`filter`	Query	`string`	Hayır	Başlıkta serbest metin araması.
`startDate`	Query	`date-time`	Hayır	Yayım tarihi alt sınırı (ISO 8601).
`endDate`	Query	`date-time`	Hayır	Yayım tarihi üst sınırı (ISO 8601).
`page`	Query	`integer`	Hayır	Sayfa numarası (1'den başlar).
`pageSize`	Query	`integer`	Hayır	Sayfa başına öğe sayısı (1-100).

Yanıtlar

200 — Başarılı — pagination zarfı ile birlikte liste.

{
  "success": true,
  "data": [
    {
      "id": "7a3f9e2c-...",
      "title": "Kripto Varlık Hizmet Sağlayıcıları Hakkında Yönetmelik",
      "sourceName": "Resmi Gazete",
      "publishedDate": "2026-03-28T00:00:00Z",
      "documentFormat": 0,
      "sourceUrl": "https://..."
    }
  ],
  "pagination": { "page": 1, "pageSize": 20, "totalCount": 42 }
}

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

curl -X GET \
  "https://api.regvion.com/api/v1/documents" \
  -H "X-API-Key: rgv_live_REPLACE_WITH_YOUR_KEY"

const url = 'https://api.regvion.com/api/v1/documents';
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"
headers = {"X-API-Key": "rgv_live_REPLACE_WITH_YOUR_KEY"}
params = {"sourceId": "value", "filter": "kripto", "startDate": "2026-01-01T00:00:00Z", "endDate": "2026-03-31T23:59:59Z", "page": "1", "pageSize": "20"}
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/documents");
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', $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"))
    .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", 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')
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")
    .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")!)
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")
        .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' -Method Get -Headers $headers

$response.data
Write-Host "Request ID:" $response.meta.requestId

Yanıt (200)

{
  "success": true,
  "data": [
    {
      "id": "7a3f9e2c-...",
      "title": "Kripto Varlık Hizmet Sağlayıcıları Hakkında Yönetmelik",
      "sourceName": "Resmi Gazete",
      "publishedDate": "2026-03-28T00:00:00Z",
      "documentFormat": 0,
      "sourceUrl": "https://..."
    }
  ],
  "pagination": { "page": 1, "pageSize": 20, "totalCount": 42 }
}