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 — null veya InstitutionType enum değerleri dizisi. null göndermek "kurum tipi filtresi yok" anlamına gelir (tüm kurum tipleri).
topics — null veya TopicType enum değerleri dizisi. Aynı mantık.
isAutoCreateEnabled — zorunlu boolean. Eksik göndermek deserialization sırasında false olarak yorumlanır.

Dizilerin etkisi

Boş dizi [] ile null farklı davranır:
- [] — "eşleşecek hiçbir değer yok" → hiçbir şey eşleşmez.
- null — "filtresiz" → tüm değerler eşleşir.
En az bir dizi null değilse her iki dizinin kesişimi boş olmamalıdır, aksi halde hiç eşleşme olmaz.

Eşleşme nasıl tetiklenir

Boru hattında yeni doküman analiz edildiğinde SubscriptionMatchingJob çalışır: regülasyonun etiketleri bu profil ile karşılaştırılır, eşleşirse PortalCase oluşturulur. Regülasyon geri dönük eşleşmez — sadece gelecekte yayımlananlar.

Parametreler

İsim	Konum	Tip	Zorunlu	Açıklama
`institutionTypes`	Body	`string[]?`	Hayır	InstitutionType enum değerlerinden dizi.
`topics`	Body	`string[]?`	Hayır	TopicType enum değerlerinden dizi.
`isAutoCreateEnabled`	Body	`boolean`	Evet	Otomatik vaka oluşturma açık mı?

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": ["Bank", "PaymentInstitution"],
  "topics": ["AntiMoneyLaundering"],
  "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": ["Bank", "PaymentInstitution"],
  "topics": ["AntiMoneyLaundering"],
  "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": ["Bank", "PaymentInstitution"],
  "topics": ["AntiMoneyLaundering"],
  "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": ["Bank", "PaymentInstitution"],
  "topics": ["AntiMoneyLaundering"],
  "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" => ["Bank", "PaymentInstitution"],
  "topics" => ["AntiMoneyLaundering"],
  "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\": [\"Bank\", \"PaymentInstitution\"],\n  \"topics\": [\"AntiMoneyLaundering\"],\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\": [\"Bank\", \"PaymentInstitution\"],\n  \"topics\": [\"AntiMoneyLaundering\"],\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": ["Bank", "PaymentInstitution"],\n  "topics": ["AntiMoneyLaundering"],\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\": [\"Bank\", \"PaymentInstitution\"],\n  \"topics\": [\"AntiMoneyLaundering\"],\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\": [\"Bank\", \"PaymentInstitution\"],\n  \"topics\": [\"AntiMoneyLaundering\"],\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\": [\"Bank\", \"PaymentInstitution\"],\n  \"topics\": [\"AntiMoneyLaundering\"],\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": ["Bank", "PaymentInstitution"],
  "topics": ["AntiMoneyLaundering"],
  "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