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ğerdir: dizide yer alırsa, kurum tipi etiketi bulunan her yükümlülük kurum boyutundan geçer (kesişim aranmaz). Eşleşme hacmini ciddi biçimde artırır; topics koşulu yine de ayrıca tutmalıdır.

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