Kiralama Tokenlerini Ara

Belirli bir kullanıcı ve token ile ilişkili kiralama tokenlerini arayın.

Endpoint

POST /v2/users/rents/users/{user_id}/tokens/{token_id}/search

Headers

Header	Value
Content-Type	application/json
Authorization	Bearer {token}

Path Parametreleri

Parametre	Tip	Gerekli	Açıklama
user_id	string	Evet	Kullanıcının benzersiz tanımlayıcısı
token_id	string	Evet	Token'ın benzersiz tanımlayıcısı

İstek Gövdesi

{
    "page": 1,
    "per_page": 10
}

Parametreler

Parametre	Tip	Gerekli	Açıklama
page	integer	Evet	Sayfalama için sayfa numarası
per_page	integer	Evet	Sayfa başına öğe sayısı

Yanıt

Kullanıcı ve token ile ilişkili kiralama tokenlerinin sayfalanmış listesini döndürür.

Başarılı Yanıt (200 OK)

{
    "data": [
        {
            "id": "string",
            "user_id": "string",
            "token_id": "string",
            "deposit_id": "string",
            "external_id": "number",
            "price": "number",
            "contract_created_at": "string",
            "created_at": "string",
            "updated_at": "string"
        }
    ],
    "total": "number",
    "page": "number",
    "per_page": "number"
}

Yanıt Alanları

Alan	Tip	Açıklama
id	string	Kiralama kaydının benzersiz tanımlayıcısı
user_id	string	Kullanıcının benzersiz tanımlayıcısı
token_id	string	Token'ın benzersiz tanımlayıcısı
deposit_id	string	Depozitonun benzersiz tanımlayıcısı
external_id	number	Harici tanımlayıcı
price	number	Kiralama fiyatı (ayarlanmamışsa null)
contract_created_at	string	Sözleşmenin oluşturulduğu zaman damgası (oluşturulmamışsa null)
created_at	string	Kaydın oluşturulduğu zaman damgası
updated_at	string	Kaydın son güncellendiği zaman damgası

Örnek

İstek

curl -X POST "{{baseUrl}}/v2/users/rents/users/680c02896d91ca0145cfeb81/tokens/68ae06cfcccf4e8fc19362d1/search" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer \{\{token\}\}" \
  -d '{
    "page": 1,
    "per_page": 10
  }'

Yanıt

{
    "data": [
        {
            "id": "68d6e57c61d63aa6705baacb",
            "user_id": "680c02896d91ca0145cfeb81",
            "token_id": "68ae06cfcccf4e8fc19362d1",
            "deposit_id": "67c918d789486081f8ca5dac",
            "external_id": 0,
            "price": null,
            "contract_created_at": null,
            "created_at": "2025-04-21T18:11:23.596Z",
            "updated_at": "2025-04-21T18:11:23.596Z"
        }
    ],
    "total": 1,
    "page": 1,
    "per_page": 10
}

Hata Yanıtları

400 Bad Request

{
    "error": "Geçersiz istek parametreleri"
}

401 Unauthorized

{
    "error": "Kimlik doğrulama gerekli"
}

403 Forbidden

{
    "error": "Erişim reddedildi"
}

404 Not Found

{
    "error": "Kullanıcı veya token bulunamadı"
}

500 Internal Server Error

{
    "error": "Sunucu iç hatası"
}