Kira Talep Et

Kullanıcının bir kira ödemesini kullanıcının cüzdanlarından birine talep eder. rent_id, Token'a Göre Kiraları Listele yanıtındaki ödemenin external_id değeridir (ObjectID değil, tam sayı). wallet_id zorunludur: talebi bu cüzdan imzalar, gas'ını öder ve ödemeyi alır. Cüzdan bu kullanıcıya ait olmalı ve token'ın zincirinde bulunmalıdır.

Talep asenkrondur. Bir kullanıcı işlemi (type = 5, kira talebi) kaydeder ve boş gövdeli 200 döndürür: işlem ID'si dönmez. Takip etmek için kullanıcının işlemlerini Kullanıcı İşlemlerini Getir ile types=5 filtresiyle listeleyin ve en yenisinin status değerinin 3 (tamamlandı) ya da 4 (hata) olmasını bekleyin. Para birimi cüzdana ancak 3 sonrasında ulaşır.

Talebi sürmekte olan ya da zaten talep edilmiş bir ödeme, hiçbir işlem oluşturulmadan 409 ile reddedilir; böylece bir yeniden deneme ya da çift gönderim iki kez talep edemez.

Gerekli izin: rent:claim

İstek

POST /v2/users/{user_id}/rents/tokens/{token_id}/{rent_id}/claim

Parametreler

Ad	Tip	Konum	Açıklama
user_id	string	path	Zorunlu. Kullanıcı ID'si
token_id	string	path	Zorunlu. Token ID'si
rent_id	integer	path	Zorunlu. Ödemenin external_id değeri

Başlıklar

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

Gövde

Alan	Tip	Zorunlu	Açıklama
wallet_id	string	Evet	Talebi imzalayan ve ödemeyi alan cüzdan (wallets._id). Kullanıcıya ait olmalı ve token'ın zincirinde bulunmalıdır

Örnek

curl --request POST \
  --url '{{baseUrl}}/v2/users/680c02896d91ca0145cfeb81/rents/tokens/68ae06cfcccf4e8fc19362d1/1/claim' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "wallet_id": "6a89b68e0c46ca4c941271aa"
  }'

Yanıt

Boş gövdeli 200 OK.

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız (wallet_id ya da pozitif tam sayı olmayan rent_id) — details alanına bakın
400	10016	user_id, token_id ya da wallet_id geçerli 24 karakterlik hex ID değil
400	10001	Domain 5: token bulunamadı (token not found) ya da bu token'da kullanıcı için bu rent_id ile ödeme yok (rent not found)
400	10015	Domain 1: wallet does not belong to this user on this network — cüzdan yok, bu kullanıcıya ait değil ya da başka bir zincirde
409	10002	Ödemenin talebi sürüyor ya da ödeme zaten talep edilmiş (domain 5)
500	10000	Beklenmeyen sunucu hatası

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