Custody Sağlayıcılarını Listele

Desteklenen her custody sağlayıcısı (rudiq, taurus) için bir satır döndürür: kayıtlı yapılandırması ya da hiç kaydedilmemiş bir sağlayıcı için "yapılandırılmamış" taslağı; böylece her sağlayıcı gösterilebilir. İkisini configured ayırt eder. Yanıt sayfalanmamış düz bir dizidir.

Custody'yi aynı anda tam olarak bir sağlayıcı yürütür: is_active: true olan. Bir sağlayıcı etkinleştirilene kadar her custody işlemi "no active custodial wallet provider configured" hatasıyla başarısız olur.

Kimlik bilgileri hiçbir zaman geri dönmez. Yalnızca her birinin kayıtlı olup olmadığı (username_set, password_set, api_key_set) ve API anahtarının son dört karakteri (api_key_last4) döner. Gelen webhook gizli değeri yalnızca webhook.secret_set olarak bildirilir.

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

Gerekli izin: custodial-wallet:view

İstek

GET /v2/admin/custodial-wallets

Başlıklar

Ad	Açıklama
Authorization	Zorunlu. Bearer <access_token>

Örnek

curl --request GET \
  --url '{{baseUrl}}/v2/admin/custodial-wallets' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

[
  {
    "provider": "rudiq",
    "host": "custody-gateway.custody.svc.cluster.local",
    "port": 8080,
    "timeout": 30,
    "is_active": true,
    "effective_active": true,
    "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": true
    },
    "created_at": "2026-09-02T08:14:51.120Z",
    "updated_at": "2026-10-21T13:05:09.774Z"
  },
  {
    "provider": "taurus",
    "host": "",
    "port": 0,
    "timeout": 0,
    "is_active": false,
    "effective_active": false,
    "username_set": false,
    "password_set": false,
    "api_key_set": false,
    "api_key_last4": "",
    "configured": false,
    "webhook": {
      "auth_type": "basic",
      "path": "/v2/webhooks/custodial",
      "url": "https://integration.example.com/v2/webhooks/custodial",
      "username": "",
      "secret_set": false
    }
  }
]

Yanıt Alanları

Alan	Tip	Açıklama
provider	string	Sağlayıcı anahtarı: rudiq ya da taurus
host	string	Sağlayıcı API'sinin host adı
port	integer	Sağlayıcı API'sinin portu
timeout	integer	Saniye cinsinden istek zaman aşımı
is_active	boolean	Custody'yi yürüten sağlayıcının bu olup olmadığı
effective_active	boolean	Bu sağlayıcının yürürlükte olup olmadığı. Her zaman is_active ile aynıdır
username_set	boolean	Kullanıcı adının kayıtlı olup olmadığı
password_set	boolean	Parolanın kayıtlı olup olmadığı
api_key_set	boolean	API anahtarının kayıtlı olup olmadığı
api_key_last4	string	Kayıtlı API anahtarının son dört karakteri; anahtar yoksa ya da dört karakter veya daha kısaysa boş
configured	boolean	Kaydedilmiş sağlayıcı için true, "yapılandırılmamış" taslağı için false
webhook	object	Gelen yön: bu sağlayıcının platformun custody webhook'unu nasıl çağırdığı. Bu değerleri custody tarafına iletin
webhook.auth_type	string	basic (username ve parola olarak gizli değer ile HTTP Basic) ya da token (gizli değer Authorization: Bearer <secret> olarak ya da X-Webhook-Token başlığında)
webhook.path	string	Webhook endpoint'inin yolu: /v2/webhooks/custodial
webhook.url	string	Webhook'un tam URL'si. Sunucuda herkese açık temel URL yapılandırılmamışsa gönderilmez
webhook.username	string	Custody'nin basic kimlik doğrulamada gönderdiği kullanıcı adı
webhook.secret_set	boolean	Webhook gizli değerinin üretilip üretilmediği. Gizli değer yalnızca bir kez, Webhook Gizli Değerini Yenile ile gösterilir
created_at	string	Oluşturulma zamanı (ISO 8601). Taslakta gönderilmez
updated_at	string	Son güncelleme zamanı (ISO 8601). Taslakta gönderilmez

Hatalar

Durum	Kod	Açıklama
403	10005	Çağıran platform sahibi değil (domain 2)

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