Dokümanlar / Uç Noktalar

Yükümlülük Detayı

GET /api/v1/obligations/{id}

Bu sayfada

Yükümlülük Detayı
Yanıt alanları
Kimlik ve metin
Aksiyon ve risk
Son tarih
Ceza
Etiketler
404 ne zaman döner

Yükümlülük Detayı

Tek bir yükümlülüğün tam detayını döner. /library/{id}/obligations veya /obligations/search listelerinden gelen id'yi takip etmek için kullanılır.

Yanıt alanları

Kimlik ve metin

id — yükümlülük ID'si
documentId — kaynak doküman
ordinal — dokümandaki sıra numarası
title — kısa başlık (tek satır)
description — tam açıklama
sourceReference — yükümlülüğün dayandığı maddenin numarası (örn. "Madde 17/1")
sourceExcerpt — ilgili maddenin orijinal metinden alıntısı

Aksiyon ve risk

actionType — Report, Implement, Prohibit, Document, FileRecord, Train, UpdatePolicy, NotifyCustomer, Other
severity — Low, Medium, High, Critical

Son tarih

deadlineDate — ayrıştırılabilen tarih (yoksa null)
deadlineKind — Explicit (kanunda kesin tarih), Relative (yayın/olay sonrası N gün), Conditional (tetikleyici olaya bağlı), Unclear (geçiyor ama net değil), None
deadlineRawText — kaynak metindeki tam ifade
deadlineSourceExcerpt — son tarihin geçtiği maddenin alıntısı

Ceza

penaltyDescription — yaptırımın metinsel açıklaması
penaltyAmountMin / penaltyAmountMax — tutar aralığı (yoksa null)
penaltyCurrency — ISO 4217 (genelde TRY)
penaltySourceExcerpt — ceza maddesinin alıntısı

Etiketler

institutionTypeIds — InstitutionType enum sayı değeri dizisi (1-21)
departmentIds — DepartmentType enum sayı değeri dizisi (1-24)
topicIds — TopicType enum sayı değeri dizisi (1-25)

Tam değer-isim eşlemesi için Enum Referansı sayfasına bakın.

404 ne zaman döner

Geçersiz UUID formatı
Yükümlülük silindi veya hiç var olmadı
Bağlı doküman tamamlanmamış (boru hattı sonunda silinmediği için pratikte bu nadiren görülür)

Parametreler

İsim	Konum	Tip	Zorunlu	Açıklama
`id`	Path	`uuid`	Evet	Yükümlülük ID'si.

Yanıtlar

200 — Yükümlülük detayı. Enum alanları (actionType, severity, deadlineKind) tamsayı olarak döner; eşleşme tablosu için Enum Referansı sayfasına bakın.

{
  "success": true,
  "data": {
    "id": "...",
    "documentId": "...",
    "ordinal": 3,
    "title": "Şüpheli işlem bildirimi yapılmalıdır",
    "description": "Yükümlü kuruluşlar...",
    "sourceReference": "Madde 17/1",
    "sourceExcerpt": "... ilgili maddenin tam metni ...",
    "actionType": 1,
    "severity": 3,
    "deadlineDate": "2026-12-31",
    "deadlineKind": 1,
    "deadlineRawText": "31.12.2026 tarihine kadar",
    "deadlineSourceExcerpt": "...",
    "penaltyDescription": "İdari para cezası...",
    "penaltyAmountMin": 50000,
    "penaltyAmountMax": 500000,
    "penaltyCurrency": "TRY",
    "penaltySourceExcerpt": "...",
    "institutionTypeIds": [1, 4],
    "departmentIds": [3],
    "topicIds": [7]
  }
}

404 — Yükümlülük bulunamadı.

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

curl -X GET \
  "https://api.regvion.com/api/v1/obligations/7a3f9e2c-4b8d-11ef-8a3c-0242ac120002" \
  -H "X-API-Key: rgv_live_REPLACE_WITH_YOUR_KEY"

const url = 'https://api.regvion.com/api/v1/obligations/7a3f9e2c-4b8d-11ef-8a3c-0242ac120002';
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/obligations/7a3f9e2c-4b8d-11ef-8a3c-0242ac120002"
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/obligations/7a3f9e2c-4b8d-11ef-8a3c-0242ac120002");
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/obligations/7a3f9e2c-4b8d-11ef-8a3c-0242ac120002', $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/obligations/7a3f9e2c-4b8d-11ef-8a3c-0242ac120002"))
    .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/obligations/7a3f9e2c-4b8d-11ef-8a3c-0242ac120002", 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/obligations/7a3f9e2c-4b8d-11ef-8a3c-0242ac120002')
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/obligations/7a3f9e2c-4b8d-11ef-8a3c-0242ac120002")
    .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/obligations/7a3f9e2c-4b8d-11ef-8a3c-0242ac120002")!)
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/obligations/7a3f9e2c-4b8d-11ef-8a3c-0242ac120002")
        .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/obligations/7a3f9e2c-4b8d-11ef-8a3c-0242ac120002' -Method Get -Headers $headers

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

Yanıt (200)

{
  "success": true,
  "data": {
    "id": "...",
    "documentId": "...",
    "ordinal": 3,
    "title": "Şüpheli işlem bildirimi yapılmalıdır",
    "description": "Yükümlü kuruluşlar...",
    "sourceReference": "Madde 17/1",
    "sourceExcerpt": "... ilgili maddenin tam metni ...",
    "actionType": 1,
    "severity": 3,
    "deadlineDate": "2026-12-31",
    "deadlineKind": 1,
    "deadlineRawText": "31.12.2026 tarihine kadar",
    "deadlineSourceExcerpt": "...",
    "penaltyDescription": "İdari para cezası...",
    "penaltyAmountMin": 50000,
    "penaltyAmountMax": 500000,
    "penaltyCurrency": "TRY",
    "penaltySourceExcerpt": "...",
    "institutionTypeIds": [1, 4],
    "departmentIds": [3],
    "topicIds": [7]
  }
}