Webhook Gizli Değerini Yenile

Sağlayıcının gelen webhook'u (custody'nin /v2/webhooks/custodial adresine yaptığı çağrılar) için yeni bir rastgele gizli değer üretir ve döndürür.

Gizli değer yalnızca bir kez, bu yanıtta döndürülür. Yalnızca hash'i saklanır; daha sonra geri okunamaz: yanıttan ayrılmadan önce kopyalayın. Önceki gizli değer hemen geçersiz olur; bu yüzden custody tarafını aynı değişiklikte güncelleyin.

Gizli değerin ne olduğu auth_type değerine bağlıdır: HTTP Basic çiftinin parolası (basic, sağlayıcının webhook.username değeriyle) ya da bearer token (token, Authorization: Bearer <secret> olarak veya X-Webhook-Token başlığında gönderilir).

İki ön koşul:

• sağlayıcı önceden Custody Sağlayıcısını Kaydet ile kaydedilmiş olmalıdır;
• basic kimlik doğrulamada sağlayıcının önceden bir webhook.username değeri olmalıdır; kullanıcı adı olmayan bir gizli değer asla kimlik doğrulayamaz.

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

POST /v2/admin/custodial-wallets/{provider}/webhook-secret

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>

Örnek

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

Yanıt

{
  "auth_type": "basic",
  "secret": "<generated_webhook_secret>"
}

Yanıt Alanları

Alan	Tip	Açıklama
auth_type	string	basic ya da token: custody'nin gizli değeri nasıl göndermesi gerektiği
secret	string	Yeni gizli değer; 32 karakterlik URL güvenli rastgele bir metin. Yalnızca burada gösterilir

Hatalar

Durum	Kod	Açıklama
400	10015	Desteklenmeyen sağlayıcı anahtarı, sağlayıcı henüz kaydedilmemiş ya da webhook.username olmadan basic kimlik doğrulama
403	10005	Çağıran platform sahibi değil (domain 2)

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