ID ile Ücret Güncelle

Var olan bir ücret satırının oranlarını, satırın kendi ID'siyle değiştirir. Satır, gövde ne içerirse içersin yazıldığı kapsamı (setup, node, node + network, network veya default) korur: bir düzenleme ücreti asla başka bir düğüme, ağa veya kuruluma taşıyamaz. Başka bir kapsamda yazmak için satırı orada oluşturan kapsam adresli uçları kullanın. Bkz. Ücretlere Genel Bakış.

Kimin düzenleyebileceği satıra bağlıdır:

• düğüm satırı (entity 3): satırın düğümü API anahtarınızın düğüm alt ağacında olmalıdır;
• platform sahibi satırı (entity 2): yalnızca platform sahibi düğümün API anahtarı;
• sahip satırı (entity 1): hiç kimse, sahip ücretleri bu API üzerinden salt okunurdur.

Satır hemen kaydedilir ve döner. Zincire gönderim asenkrondur ve saklanan kapsamı izler:

• kurulum satırı, kurulum dağıtılmışsa ve oranlar ya da kategoriler değiştiyse doğrudan o kuruluma gönderilir: kurulumun düğümünde 10 tipinde tek bir düğüm işlemi;
• daha geniş her satır onu devralan her dağıtılmış kuruluma yayılır (düğüm satırları için 10, 11; platform sahibi satırları için 12, 13 tiplerinde düğüm işlemleri); dağıtılmış kurulumlara gönderilmeyen platform sahibi varsayılanı hariç.

Sonucu Get Node Transactions ile sorgulayın.

Gerekli izin: fee:upsert

İstek

PUT /v2/admin/fees/{fee_id}

Parametreler

Ad	Tip	Konum	Açıklama
fee_id	string	path	Zorunlu. Ücret satırı 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. Satırın override'larının yerini alır. 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

Gövdedeki entity, node_id, network_id, setup_id veya platform_owner_id yok sayılır.

Örnek

curl --request PUT \
  --url '{{baseUrl}}/v2/admin/fees/680be1f55d63bcee848d38e7' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "value": {
      "tokenization": {
        "asset_tokenization": { "value": "5" },
        "tokenized_asset_sales": { "value": "6" },
        "management": { "value": "7" }
      },
      "secondary_market": {
        "buy_order": { "value": "8" },
        "sell_order": { "value": "9" },
        "otc_sale": { "value": "10" }
      },
      "lending": {
        "borrower": { "value": "11" },
        "lending": { "value": "12" },
        "liquidation": { "value": "13" }
      }
    },
    "categories": null
  }'

Yanıt

{
  "id": "680be1f55d63bcee848d38e7",
  "entity": 3,
  "node_id": "6a4bef2b1e781b11c22e9707",
  "network_id": "6a4bf0a21e781b11c22e9712",
  "value": {
    "tokenization": {
      "asset_tokenization": { "id": 0, "value": "5" },
      "tokenized_asset_sales": { "id": 0, "value": "6" },
      "management": { "id": 0, "value": "7" }
    },
    "secondary_market": {
      "buy_order": { "id": 0, "value": "8" },
      "sell_order": { "id": 0, "value": "9" },
      "otc_sale": { "id": 0, "value": "10" }
    },
    "lending": {
      "borrower": { "id": 0, "value": "11" },
      "lending": { "id": 0, "value": "12" },
      "liquidation": { "id": 0, "value": "13" }
    }
  },
  "categories": null
}

Yanıt Alanları

Kaydedilen ücret satırı, ID ile Ücret Al ile aynı biçimde: id, entity, satırın taşıdığı kapsam alanları (node_id, setup_id, network_id, platform_owner_id), value ve categories.

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	fee_id 24 karakterlik bir hex ID değil
400	10001 (domain 9)	Ücret bulunamadı
400	10002 (domain 9)	value dokuz oranın tamamını içermiyor
400	10001 (domain 4)	Bir categories[].id mevcut değil
400	10001 (domain 2)	Satırın düğümü (ya da kurulum satırında kurulumu) bulunamadı
403	10003 (domain 9)	Platform sahibi veya sahip satırı, platform sahibi düğüme ait olmayan bir anahtarla düzenlendi
403	10004 (domain 9)	Satır bir sahip ücreti; bu API üzerinden salt okunurdur
403	10005 (domain 2)	Satırın 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.