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",
"total_price": {
"id": "string",
"amount": "number",
"decimal": "number",
"symbol": "string",
"address": "string"
},
"per_price": {
"id": "string",
"amount": "number",
"decimal": "number",
"symbol": "string",
"address": "string"
},
"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ı |
| total_price | object | Kiralama için toplam fiyat bilgisi |
| total_price.id | string | Para birimi token kimliği |
| total_price.amount | number | Toplam fiyat miktarı |
| total_price.decimal | number | Ondalık basamak sayısı |
| total_price.symbol | string | Para birimi sembolü (örn. "VUSD") |
| total_price.address | string | Para birimi token'ının sözleşme adresi |
| per_price | object | Token başına fiyat bilgisi |
| per_price.id | string | Para birimi token kimliği |
| per_price.amount | number | Token başına fiyat miktarı |
| per_price.decimal | number | Ondalık basamak sayısı |
| per_price.symbol | string | Para birimi sembolü (örn. "VUSD") |
| per_price.address | string | Para birimi token'ının sözleşme adresi |
| contract_created_at | string | null | 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 --location 'https://test-integration-api.tokenizationtr.com/v2/users/rents/users/6913872755654191dede37da/tokens/691331aec95e268b239b2d91/search' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjbGllbnRJRCI6Ijk3MWNlZGVmLWVlZDctNDcwZi04YWIzLTBhZTM3ZDc0NTY4NCIsImV4cGlyYXRpb24iOjE3NjMwODM3NjcsInN1cGVydmlzb3JFbWFpbCI6ImRldkBydWRpcS5jb20iLCJzdXBlcnZpc29ySUQiOiI2OGQyODBiYmM1ODA3M2NkZjU2NDJkMjAiLCJzdXBlcnZpc29yTm9kZUlEIjoiNjY1YWU1MzZhNjM5MmI3NWNmZDQwMzUyIiwic3VwZXJ2aXNvck5vZGVJbnRJRCI6MSwic3VwZXJ2aXNvck5vZGVQYXRoIjoiMSIsInN1cGVydmlzb3JSb2xlSUQiOiI2NjVhZTc5NjEwY2UyMTZkYmMzNWM5M2IiLCJzdXBlcnZpc29yUm9sZVByaW9yaXR5IjoxMDB9.0l-NJTDICHXuhwb0PGX6wwXO50zhMysxepUntC1sxJY' \
--data '{
"page": 1,
"per_page": 10
}'
Yanıt
{
"data": [
{
"id": "6915ced75df7fa80499a5beb",
"user_id": "6913872755654191dede37da",
"token_id": "691331aec95e268b239b2d91",
"deposit_id": "6915ced75df7fa80499a5bea",
"external_id": 1,
"total_price": {
"id": "6913307ec95e268b239b2d8b",
"amount": 0.0005,
"decimal": 6,
"symbol": "VUSD",
"address": "0x99f750b4a041974bfa3c072580dd4db37e2fdb18"
},
"per_price": {
"id": "6913307ec95e268b239b2d8b",
"amount": 0.0001,
"decimal": 6,
"symbol": "VUSD",
"address": "0x99f750b4a041974bfa3c072580dd4db37e2fdb18"
},
"contract_created_at": null,
"created_at": "2025-11-13T12:28:07.361Z",
"updated_at": "2025-11-13T12:28:07.361Z"
}
],
"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ı"
}