Ücretlere Genel Bakış
Ücret (fee), bir tarafın platformdaki işlemlerden aldığı yüzde oranlarının kümesidir. Bu sayfa bir ücreti kimin aldığını, bir ücretin hangi kapsamlarda yazılabildiğini, bir kuruluma (setup) uygulanan oranın nasıl çözümlendiğini ve bir değişikliğin ne zaman zincire gittiğini anlatır. Bu bölümdeki endpoint sayfaları buraya bağlantı verir.
Ücretleri Listele
Bir entity'nin fiyatlandığı ücret satırlarını listeler; isteğe bağlı olarak tek bir düğüme ve/veya tek bir ağa daraltılabilir. Tek ücret listesi budur: /fees/owner (artık ?entity=1), /fees/platform-owner/defaults (?entity=2), /fees/nodes//defaults (?entity=3&nodeid=) ve /fees/nodes/{nodeid}/platform-owner/defaults (?entity=2&nodeid=) uçlarının yerini aldı. Entity ve kapsamlar için Ücretlere Genel Bakış sayfasına bakın.
ID ile Ücret Al
Bir ücret satırını, hangi kapsamda yazılmış olursa olsun (setup, node, network veya default), kendi ID'siyle okur. Kimin okuyabileceğine satırın kendi kapsamı karar verir: düğüm ücreti (entity 3) için düğümün API anahtarınızın düğüm alt ağacında olması gerekir; sahip veya platform sahibi ücreti (entity 1 veya 2) için platform sahibi düğümün API anahtarı gerekir. Bkz. Ücretlere Genel Bakış.
Geçerli Ücreti Al
Bir entity'nin verilen kapsamda ne aldığını anlık olarak çözümler: sunucu setup → node + network → node → network → default sırasını dolaşır ve her seviye yalnızca daha özel seviyelerin boş bıraktığı oranları doldurur (bkz. Ücretlere Genel Bakış). Bir ekseni göndermemek, o eksene ihtiyaç duyan seviyeleri atlatır; daha geniş bir kapsamın neye çözümlendiğini böyle sorarsınız. Bir dağıtımı değil saklanan ücret satırlarını okuduğu için henüz dağıtımı olmayan kapsamlar için de yanıt verir; böylece bir değişikliği gönderilmeden önce önizleyebilirsiniz. Dağıtılmış bir kurulumun kontratının gerçekte tuttuğu değerler için Kurulumun Geçerli Ücretlerini Al ucunu kullanın.
Etkilenen Kurulum Sayısını Al
Düğüm veya ağ genelindeki bir ücret değişikliğinin kaç dağıtılmış kuruluma gönderileceğini, değişikliği yapmadan önce sayar. Bu kapsamlardaki bir değişiklik onu devralan her dağıtılmış kuruluma yayılır (bkz. Ücretlere Genel Bakış); bu sayı, zincir üstü ücretleri değişebilecek kurulumların sayısıdır.
Platform Sahibi Ücretini Al
Platform sahibinin varsayılan ücretini okur: düğümü ve kurulumu olmayan entity 2 satırı (bkz. Ücretlere Genel Bakış). Her API anahtarı okuyabilir. Gösterilen oranlar, varsa bu satır için zincirde en son onaylanan değerlerdir; yoksa saklanan değerlerdir.
Platform Sahibi Ücretini Oluştur veya Güncelle
Platform sahibinin varsayılan ücretini oluşturur ya da değiştirir: düğümü ve kurulumu olmayan entity 2 satırı (bkz. Ücretlere Genel Bakış). Bu ucu yalnızca platform sahibi düğümün kendi API anahtarı çağırabilir; diğer her anahtar 403 alır.
Düğüm Ücretini Oluştur veya Güncelle
Bir düğümün kendi ücretini (entity 3) tek bir kurulumdan daha geniş bir kapsamda oluşturur ya da değiştirir: düğüm genelindeki satır veya gövde network_id taşıyorsa düğümün tek bir ağdaki satırı. Düğüm API anahtarınızın düğüm alt ağacında olmalıdır. Kurulum bazlı override bunun yerine Kurulum Ücretini Oluştur veya Güncelle ile yazılır.
Düğüm Platform Sahibi Ücretini Oluştur veya Güncelle
Platform sahibinin tek bir düğümden ne aldığını (entity 2) oluşturur ya da değiştirir: tüm ağlarda veya gövde network_id taşıyorsa tek bir ağda. Bu ucu yalnızca platform sahibi düğümün kendi API anahtarı çağırabilir; diğer her anahtar 403 alır.
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ış.
Kurulum Ücretini Al
Bir kuruluma uygulanan düğüm ücreti (entity 3) satırını okur: kurulumun kendi override'ı varsa onu, yoksa düğümün kurulum kapsamlı olmayan satırlarından birini. Gösterilen oranlar, varsa o satır için zincirde en son onaylanan değerlerdir; yoksa saklanan değerlerdir. Düğüm API anahtarınızın düğüm alt ağacında olmalı ve kurulum o düğüme ait olmalıdır.
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ış.
Kurulumun Geçerli Ücretlerini Al
Bir kurulumun entity bazında (sahip, platform sahibi, düğüm) geçerli ücretlerini, kurulumun ücret kontratına en son gönderildiği haliyle döner: çözümlenmiş oranlar, her oranın geldiği kapsam seviyesi ve ücret satırı, kategori bazlı override'lar ve bu gönderimin hâlâ pending, zincirde confirmed ya da failed olup olmadığı. Düğüm API anahtarınızın düğüm alt ağacında olmalı ve kurulum o düğüme ait olmalıdır.
Kurulum Sahip Ücretini Al
Tek bir kurulum için sahibin ücret satırını (entity 1) okur. Sahip ücretleri sahip tarafında yazılır ve sahibin değişikliği zincirde onaylandığında buraya yansıtılır; bu yüzden bu uç salt okunurdur. 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ış.
Kurulum Platform Sahibi Ücretini Al
Bir kuruluma uygulanan platform sahibi ücret satırını (entity 2) okur: varsa platform sahibinin bu kurulum için override'ını, yoksa platform sahibinin kurulumun düğümü için kurulum kapsamlı olmayan satırını. Düğüm API anahtarınızın düğüm alt ağacında olmalı ve kurulum o düğüme ait olmalıdır.
Kurulum Platform Sahibi Ücretini Oluştur veya Güncelle
Platform sahibinin tek bir kurulumdan ne aldığını (entity 2, kuruluma kapsamlı ve kurulumun ağıyla damgalı) oluşturur ya da değiştirir. Bu ucu yalnızca platform sahibi düğümün kendi API anahtarı çağırabilir; diğer her anahtar 403 alır. Kurulum o düğüme ait olmalıdır. Bkz. Ücretlere Genel Bakış.