Custody Sağlayıcısını Kaydet

Bir custody sağlayıcısının yapılandırmasını oluşturur ya da günceller. Kaydetmek hangi sağlayıcının aktif olduğunu hiçbir zaman değiştirmez: yeni bir sağlayıcı pasif oluşturulur, mevcut bir sağlayıcı is_active değerini korur. Geçiş için Custody Sağlayıcısını Etkinleştir uç noktasını kullanın.

Kimlik bilgileri bilerek null olabilir. username, password ya da api_key değerlerini geri okuyamazsınız; bu yüzden onları göndermeyen bir kayıt onları silmemelidir:

• gönderilmezse ya da null ise kayıtlı değer korunur;
• "" değeri siler;
• başka herhangi bir metin onun yerine geçer.

webhook.auth_type ve webhook.username de aynı şekilde çalışır (gönderilmezse ya da null ise korunur). Webhook gizli değeri burada yazılamaz: Webhook Gizli Değerini Yenile ile üretilir ve yalnızca hash'i saklanır. host, port ve timeout her zaman gönderildiği gibi yazılır.

Bir kaydın kontrol edildiği kurallar:

• Kayıtlı gizli değerler endpoint'leriyle kalır. Kayıtlı bir password, api_key ya da istemci sertifikası taşınacakken sağlayıcıyı başka bir host veya port'a taşımak, yeniden gönderilmesi gereken her alanı (password, api_key, client_key) belirten 10015 ile reddedilir. İstemci sertifikası bu API üzerinden gönderilemez; bu yüzden sertifikası olan bir sağlayıcı burada başka bir endpoint'e taşınamaz.
• Düz http yalnızca küme içinde. Bu API TLS'i açamaz; sağlayıcı mevcut TLS ayarını korur, yeni sağlayıcı TLS kapalı başlar. TLS kapalıyken host ortam için listelenmiş bir küme içi host olmalıdır; aksi halde kayıt host alanını belirten 10015 ile reddedilir.
• Basic webhook çifti bütün tutulur. webhook.auth_type basic iken ve gizli değer zaten üretilmişse webhook.username silinemez (ya da basic'e geçerken boş bırakılamaz).

Yalnızca platform sahibi. Çağıranın düğümü platformun kök düğümü olmalıdır; diğer çağıranlar 403 / 10005 ile reddedilir.

Gerekli izin: custodial-wallet:update

İstek

PUT /v2/admin/custodial-wallets/{provider}

Parametreler

Ad	Tip	Konum	Açıklama
provider	string	path	Zorunlu. Sağlayıcı anahtarı: rudiq ya da taurus

Başlıklar

Ad	Açıklama
Authorization	Zorunlu. Bearer <access_token>
Content-Type	Zorunlu. application/json

Gövde

Alan	Tip	Zorunlu	Açıklama
host	string	Evet	Sağlayıcı API'sinin şema, port ya da yol içermeyen host adı
port	integer	Hayır	Sağlayıcı API'sinin portu, 0 veya daha büyük
timeout	integer	Hayır	Saniye cinsinden istek zaman aşımı, 0 veya daha büyük
username	string | null	Hayır	Platformun custody'ye sunduğu kullanıcı adı. null korur, "" siler
password	string | null	Hayır	Platformun custody'ye sunduğu parola. null korur, "" siler
api_key	string | null	Hayır	Platformun custody'ye sunduğu API anahtarı. null korur, "" siler
webhook	object | null	Hayır	Gelen webhook ayarları. Gönderilmezse ya da null ise ikisi de korunur
webhook.auth_type	string | null	Hayır	basic ya da token. null kayıtlı değeri korur (yeni sağlayıcıda basic)
webhook.username	string | null	Hayır	Custody'nin basic kimlik doğrulamada gönderdiği kullanıcı adı. null korur

Örnek

curl --request PUT \
  --url '{{baseUrl}}/v2/admin/custodial-wallets/rudiq' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "host": "custody-gateway.custody.svc.cluster.local",
    "port": 8080,
    "timeout": 30,
    "username": null,
    "password": null,
    "api_key": "<custody_api_key>",
    "webhook": {
      "auth_type": "basic",
      "username": "apex-custody"
    }
  }'

Yanıt

Kaydedilen sağlayıcıyla birlikte 200 OK; Custody Sağlayıcılarını Listele sayfasındaki gibi maskelenmiştir.

{
  "provider": "rudiq",
  "host": "custody-gateway.custody.svc.cluster.local",
  "port": 8080,
  "timeout": 30,
  "is_active": false,
  "effective_active": false,
  "username_set": false,
  "password_set": false,
  "api_key_set": true,
  "api_key_last4": "7c1e",
  "configured": true,
  "webhook": {
    "auth_type": "basic",
    "path": "/v2/webhooks/custodial",
    "url": "https://integration.example.com/v2/webhooks/custodial",
    "username": "apex-custody",
    "secret_set": false
  },
  "created_at": "2026-11-09T11:02:37.640Z",
  "updated_at": "2026-11-09T11:02:37.640Z"
}

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız (host eksik, negatif port ya da timeout), desteklenmeyen sağlayıcı anahtarı, desteklenmeyen webhook.auth_type, kullanıcı adı olmadan kalan basic webhook gizli değeri ya da (details ile) yeni bir endpoint'e taşınacak kayıtlı bir gizli değer veya küme dışında düz http host
403	10005	Çağıran platform sahibi değil (domain 2)

Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.