Kurulum Ücretini Oluştur veya Güncelle

Bir düğümün tek bir kurulum için ücret override'ını (entity 3) oluşturur ya da değiştirir. Satır kuruluma kapsamlanır ve kurulumun ağıyla damgalanır. Düğüm API anahtarınızın düğüm alt ağacında olmalı ve kurulum o düğüme ait olmalıdır. Bkz. Ücretlere Genel Bakış.

Satır hemen kaydedilir ve döner. Kurulum dağıtılmışsa ve bu onun ilk override'ıysa ya da oranlar değiştiyse yeni ücret o kurulumun kontratlarına asenkron olarak gönderilir: düğümde 10 (UpdateDefaultNodeFee) tipinde bir düğüm işlemi başlatılır. Bunu Get Node Transactions ile sorgulayın. Henüz dağıtılmamış bir kurulumda satır yalnızca kaydedilir ve dağıtım onu kullanır. Yalnızca categories değişikliği gönderim başlatmaz.

Gerekli izin: fee:upsert

İstek

PUT /v2/admin/fees/nodes/{node_id}/setups/{setup_id}

Parametreler

Ad	Tip	Konum	Açıklama
node_id	string	path	Zorunlu. Kurulumun sahibi olan düğüm
setup_id	string	path	Zorunlu. Kurulum ID'si

Başlıklar

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

Gövde

Alan	Tip	Zorunlu	Açıklama
value	object	Evet	Dokuz oran. Dokuz yaprağın tamamı zorunludur: tokenization.asset_tokenization, tokenization.tokenized_asset_sales, tokenization.management, secondary_market.buy_order, secondary_market.sell_order, secondary_market.otc_sale, lending.borrower, lending.lending, lending.liquidation
value.<group>.<leaf>.value	string	Evet	Yüzde olarak oran, "0" ile "100" arası, en fazla bir ondalık (örneğin "2.5"). Bkz. Tutarlar ve Yüzdeler
categories	array veya null	Hayır	Varlık kategorisi bazlı override'lar. Bir üst kategoriye verilen override, yaprak kategorilerine uygulanır
categories[].id	string	Evet	Kategori ID'si (24 karakter hex)
categories[].value	object	Evet	Bu kategorinin oranları, value ile aynı biçimde

Örnek

curl --request PUT \
  --url '{{baseUrl}}/v2/admin/fees/nodes/6a4bef2b1e781b11c22e9707/setups/6a552db09c6088e126a4be87' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "value": {
      "tokenization": {
        "asset_tokenization": { "value": "3.5" },
        "tokenized_asset_sales": { "value": "1" },
        "management": { "value": "0.5" }
      },
      "secondary_market": {
        "buy_order": { "value": "1" },
        "sell_order": { "value": "1" },
        "otc_sale": { "value": "1.5" }
      },
      "lending": {
        "borrower": { "value": "0" },
        "lending": { "value": "0" },
        "liquidation": { "value": "0" }
      }
    },
    "categories": null
  }'

Yanıt

{
  "id": "6a5530c19c6088e126a4be9a",
  "entity": 3,
  "node_id": "6a4bef2b1e781b11c22e9707",
  "setup_id": "6a552db09c6088e126a4be87",
  "network_id": "6a4bf0a21e781b11c22e9712",
  "value": {
    "tokenization": {
      "asset_tokenization": { "id": 0, "value": "3.5" },
      "tokenized_asset_sales": { "id": 0, "value": "1" },
      "management": { "id": 0, "value": "0.5" }
    },
    "secondary_market": {
      "buy_order": { "id": 0, "value": "1" },
      "sell_order": { "id": 0, "value": "1" },
      "otc_sale": { "id": 0, "value": "1.5" }
    },
    "lending": {
      "borrower": { "id": 0, "value": "0" },
      "lending": { "id": 0, "value": "0" },
      "liquidation": { "id": 0, "value": "0" }
    }
  },
  "categories": null
}

Yanıt Alanları

Kaydedilen ücret satırı, ID ile Ücret Al ile aynı biçimde.

Alan	Tip	Açıklama
id	string	Ücret satırı ID'si
entity	integer	3 (düğüm)
node_id	string	Path'teki düğüm
setup_id	string	Path'teki kurulum
network_id	string	Kurulumun ağı
value	object	Kaydedilen oranlar. Her yaprak { "id": 0, "value": "<percent>" } biçimindedir
categories	array veya null	Yaprak kategorilere açılmış, kaydedilen kategori override'ları (id, int_id, path, value)

Yanıt düğüm işleminin ID'sini taşımaz; onu Get Node Transactions ile bulun.

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız — details alanına bakın. Hatalı biçimli bir oran da burada bildirilir
400	10016	node_id veya setup_id 24 karakterlik bir hex ID değil
400	10001 (domain 2)	Düğüm bulunamadı ya da kurulum o düğüme ait değil
400	10002 (domain 9)	value dokuz oranın tamamını içermiyor
400	10001 (domain 4)	Bir categories[].id mevcut değil
403	10005 (domain 2)	Düğüm, API anahtarınızın düğüm alt ağacının dışında
500	10000	Beklenmeyen sunucu hatası

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