Dokümanlar / Uç Noktalar

Abonelik Profili (Güncelle)

PUT /api/v1/subscriptions/profile

Bu sayfada

Abonelik Profili (Güncelle)
İstek gövdesi
Dizilerin etkisi
Eşleşme nasıl tetiklenir

Abonelik Profili (Güncelle)

Otomatik eşleşme profilini günceller. Profil yoksa oluşturur — upsert davranışlıdır. Gövde yeni durumun tamamını içermelidir; sunucu tarafında alan bazlı merge yoktur.

İstek gövdesi

institutionTypes — InstitutionType enum sayı değerleri dizisi (örn. [1, 8]). Enum ismi kabul edilmez; ["Banka"] göndermek gövdeyi çözümlenemez hale getirir ve istek 400 ile reddedilir. null veya [] gönderilebilir (aşağıya bakın).
topics — TopicType enum sayı değerleri dizisi. Aynı mantık.
isAutoCreateEnabled — boolean, her istekte gönderilmelidir. Sunucu bunu doğrulamaz: eksik gönderilen istek hata vermez, alan false kabul edilir ve otomatik vaka oluşturma sessizce kapanır.

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

Dizilerin etkisi

null ile boş dizi [] aynı davranır: her ikisi de "eşleşecek değer yok" anlamına gelir ve hiçbir eşleşme üretmez. null "filtresiz" anlamına GELMEZ.
Otomatik eşleşme için her iki dizinin de en az bir değer içermesi gerekir: bir yükümlülük hem institutionTypes içindeki bir kurum tipiyle hem de topics içindeki bir konuyla etiketlenmiş olmalıdır. Tek başına kurum tipi eşleşmesi vaka açmaz.
20 (Tüm Finansal Kuruluşlar) joker değer değildir; diğer değerler gibi bir etikettir ve kesişimle eşleşir. 20 değeri yalnızca 20 ile etiketlenmiş yükümlülüklerle (tüm finansal sektörü ilgilendiren yatay düzenlemeler) eşleşir; dizideki diğer değerler kendi etiketleriyle eşleşmeye devam eder ([1, 20]: 1 veya 20 etiketli yükümlülükler). Yalnızca başka bir kurum tipiyle (örn. 14) etiketlenmiş bir yükümlülük 20 sayesinde eşleşmez. topics koşulu her durumda ayrıca tutmalıdır. (1 Ekim 2026'ya kadar 20, kurum tipi etiketi bulunan her yükümlülükle eşleşiyordu.)

Eşleşme nasıl tetiklenir

Yeni bir regülasyon yayımlandığında, içinden çıkarılan her yükümlülüğün kurum tipi ve konu etiketleri bu profil ile karşılaştırılır; eşleşirse Compliance Portal'da otomatik olarak bir vaka açılır. Profil değişiklikleri geri dönük çalışmaz — yalnızca güncelleme sonrası yayımlanan regülasyonlar değerlendirilir.

Parametreler

İsim	Konum	Tip	Zorunlu	Açıklama
`institutionTypes`	Body	`integer[]?`	Hayır	Kurum tipi etiketleri — InstitutionType enum SAYI değeri dizisi (1-22), enum ismi değil. İsim string'i gönderilirse istek 400 ile reddedilir. Tam eşleme: Enum Referansı.
`topics`	Body	`integer[]?`	Hayır	Konu etiketleri — TopicType enum SAYI değeri dizisi (1-25), enum ismi değil. Tam eşleme: Enum Referansı.
`isAutoCreateEnabled`	Body	`boolean`	Evet	Otomatik vaka oluşturma açık mı? Gövde tam değiştirme olduğu için her istekte gönderilmelidir. Sunucu bunu doğrulamaz: eksik gönderilirse istek 400 değil 200 döner ve alan false kabul edilerek otomatik vaka oluşturma kapanır.

Yanıtlar

200 — Güncellenmiş profil.

404 — Tenant bağlantısı yok.

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

curl -X PUT \
  "https://api.regvion.com/api/v1/subscriptions/profile" \
  -H "X-API-Key: rgv_live_REPLACE_WITH_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "institutionTypes": [1, 8],
  "topics": [1],
  "isAutoCreateEnabled": true
}'

const url = 'https://api.regvion.com/api/v1/subscriptions/profile';
const headers = {
  'X-API-Key': 'rgv_live_REPLACE_WITH_YOUR_KEY'
  , 'Content-Type': 'application/json'
};

const response = await fetch(url, {
  method: 'PUT',
  headers,
  body: JSON.stringify({
  "institutionTypes": [1, 8],
  "topics": [1],
  "isAutoCreateEnabled": true
})
});

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/subscriptions/profile"
headers = {"X-API-Key": "rgv_live_REPLACE_WITH_YOUR_KEY"}
payload = {
  "institutionTypes": [1, 8],
  "topics": [1],
  "isAutoCreateEnabled": True
}
response = requests.put(url, headers=headers, json=payload)
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 payload = new StringContent("""{
  "institutionTypes": [1, 8],
  "topics": [1],
  "isAutoCreateEnabled": true
}""", Encoding.UTF8, "application/json");
var response = await client.PutAsync("https://api.regvion.com/api/v1/subscriptions/profile", payload);
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',
    ],
    'json' => [
  "institutionTypes" => [1, 8],
  "topics" => [1],
  "isAutoCreateEnabled" => true
],
];

$response = $client->request('PUT', 'https://api.regvion.com/api/v1/subscriptions/profile', $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/subscriptions/profile"))
    .header("X-API-Key", "rgv_live_REPLACE_WITH_YOUR_KEY")
    .header("Content-Type", "application/json")
    .PUT(BodyPublishers.ofString("{\n  \"institutionTypes\": [1, 8],\n  \"topics\": [1],\n  \"isAutoCreateEnabled\": true\n}"));

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() {
    body := bytes.NewReader([]byte("{\n  \"institutionTypes\": [1, 8],\n  \"topics\": [1],\n  \"isAutoCreateEnabled\": true\n}"))
    req, _ := http.NewRequest("PUT", "https://api.regvion.com/api/v1/subscriptions/profile", body)
    req.Header.Set("Content-Type", "application/json")
    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/subscriptions/profile')
request = Net::HTTP::Put.new(uri)
request['X-API-Key'] = 'rgv_live_REPLACE_WITH_YOUR_KEY'
request['Content-Type'] = 'application/json'
request.body = '{\n  "institutionTypes": [1, 8],\n  "topics": [1],\n  "isAutoCreateEnabled": true\n}'

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/subscriptions/profile")
    .addHeader("X-API-Key", "rgv_live_REPLACE_WITH_YOUR_KEY")
    .post("{\n  \"institutionTypes\": [1, 8],\n  \"topics\": [1],\n  \"isAutoCreateEnabled\": true\n}".toRequestBody("application/json".toMediaType()))

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/subscriptions/profile")!)
request.httpMethod = "PUT"
request.setValue("rgv_live_REPLACE_WITH_YOUR_KEY", forHTTPHeaderField: "X-API-Key")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = "{\n  \"institutionTypes\": [1, 8],\n  \"topics\": [1],\n  \"isAutoCreateEnabled\": true\n}".data(using: .utf8)

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.put("https://api.regvion.com/api/v1/subscriptions/profile")
        .header("X-API-Key", "rgv_live_REPLACE_WITH_YOUR_KEY")
        .header("Content-Type", "application/json")
        .body("{\n  \"institutionTypes\": [1, 8],\n  \"topics\": [1],\n  \"isAutoCreateEnabled\": true\n}")
        ;
    let res = req.send()?;
    println!("Status: {}", res.status());
    println!("{}", res.text()?);
    Ok(())
}

$headers = @{
    'X-API-Key' = 'rgv_live_REPLACE_WITH_YOUR_KEY'
}

$body = @'
{
  "institutionTypes": [1, 8],
  "topics": [1],
  "isAutoCreateEnabled": true
}
'@

$response = Invoke-RestMethod -Uri 'https://api.regvion.com/api/v1/subscriptions/profile' -Method Put `
    -Headers $headers -Body $body -ContentType 'application/json'

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