Kira Geliri Dağıt
Token'ın bir dönemlik kira gelirini sahiplerine dağıtır. Yalnızca en az metric.min_tokens_required_for_rental_income kadar token'ı olan sahiplere ödeme yapılır. Token'ın kira koşulları ayarlanmış olmalıdır (bkz. Token Metriğini Güncelle); dağıtımın ne ödeyeceğini görmek için önce Kira Özetini Getir uç noktasını okuyun.
Çağrı asenkrondur: bir TokenRent işlemi (tip 3) kuyruğa alır ve id'sini döner. ID ile Token İşlemi Getir ile sorgulayın. Dağıtım, kontrat çağrısı gönderildiğinde Token Dağıtımlarını Getir içinde beklemede (status: 1) görünür; onaylandığında sonuçlanmış (status: 0), başarısız olduğunda iptal edilmiş (status: 2) olur. Sahip başına ödemeler sonuçlanmada kaydedilir ve Token Kira Ödemelerini Getir ile listelenir.
Gerekli izin: token:payment-rent
İstek
POST /v2/admin/tokens/{token_id}/rent
Parametreler
| Ad | Tip | Konum | Açıklama |
|---|---|---|---|
token_id | string | path | Zorunlu. Token id'si. |
Başlıklar
| Ad | Açıklama |
|---|---|
Authorization | Zorunlu. Bearer <access_token> |
Örnek
curl --request POST \
--url '{{baseUrl}}/v2/admin/tokens/67d8774e903bfcbe7eb5d93e/rent' \
--header 'Authorization: Bearer <access_token>'
Yanıt
{
"transaction_id": "6a8b5e13f9129816a6cc7a12"
}
Yanıt Alanları
| Alan | Tip | Açıklama |
|---|---|---|
transaction_id | string | TokenRent işlemi. ID ile Token İşlemi Getir ile sorgulayın. |
Hatalar
| Durum | Kod | Açıklama |
|---|---|---|
| 400 | 10016 | token_id geçerli bir id değil |
| 400 | 10001 | Token bulunamadı (token domain'i 5) |
| 400 | 10023 | Token için kira geliri yapılandırılmamış (token domain'i 5) |
| 403 | 10005 | Çağıranın düğümü token'ın düğümünü kapsamıyor (düğüm domain'i 2) |
Kabulden sonraki bir başarısızlık işlemi 4 (Error) durumunda bitirir; nedeni error alanındadır. Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.