ID ile Token Geçmişi

Belirtilen token için değişiklik geçmişini sayfalama ve filtreleme seçenekleriyle getirir.

İstek

GET /v2/admin/tokens/{tokenID}/history

Parametreler

Ad	Tip	Konum	Açıklama
tokenID	string	path	Zorunlu. Token kimliği

Sorgu Parametreleri

Ad	Tip	Zorunlu	Açıklama
page	integer	Hayır	Sayfa numarası (varsayılan: 1)
per_page	integer	Hayır	Sayfa başına öğe sayısı (varsayılan: 20)
start_date	string	Hayır	Başlangıç tarihi filtresi ISO 8601 formatında (örn., 2025-01-01T00:00:00Z)
end_date	string	Hayır	Bitiş tarihi filtresi ISO 8601 formatında (örn., 2025-12-31T23:59:59Z)
change_type	string	Hayır	Değişiklik tipine göre filtre: value_update veya metric_update
change_reason	string	Hayır	Değişiklik nedenine göre filtre: manual_update, market_adjustment veya system_update
changed_by	string	Hayır	Değişikliği yapan denetçinin kimliğine göre filtre

Başlıklar

Ad	Açıklama
Authorization	Zorunlu. Kimlik doğrulama için Bearer token
Content-Type	Zorunlu. application/json olmalı

Örnek

curl --location 'http://localhost:3453/v2/admin/tokens/6901599cbd0fb7ece2803764/history?page=1&per_page=20&start_date=2025-01-01T00%3A00%3A00Z&end_date=2025-12-31T23%3A59%3A59Z' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjbGllbnRJRCI6IjhmMzEwOWExLTYyMmMtNDVhZC1hYjI4LTg0ODE5N2ZiMDYwYSIsImV4cGlyYXRpb24iOjE3NjMwNzg1MjQsInN1cGVydmlzb3JFbWFpbCI6InViZXJAYXBleC5jb20iLCJzdXBlcnZpc29ySUQiOiI2NjViMzcyZjNhNzJkN2QwNzkxNTk2YmEiLCJzdXBlcnZpc29yTm9kZUlEIjoiNjY1YWU1MzZhNjM5MmI3NWNmZDQwMzUyIiwic3VwZXJ2aXNvck5vZGVJbnRJRCI6MSwic3VwZXJ2aXNvck5vZGVQYXRoIjoiMSIsInN1cGVydmlzb3JSb2xlSUQiOiI2NjVhZTc5NjEwY2UyMTZkYmMzNWM5M2IiLCJzdXBlcnZpc29yUm9sZVByaW9yaXR5IjoxMDB9.5e1neSV0QQmYGIs42Z9qarTKY3pkSQWutDnl34xYg04'

Yanıt

{
    "data": [
        {
            "id": "69015cb6bd0fb7ece2803767",
            "token_id": "6901599cbd0fb7ece2803764",
            "node_id": "6901350deb7ed8c1c38de4e9",
            "changed_by": "665b372f3a72d7d0791596ba",
            "change_type": "metric_update",
            "change_reason": "manual_update",
            "metric_change": {
                "term_duration_in_months": 10,
                "min_purchase_quantity": 1,
                "max_purchase_quantity": 10,
                "min_tokens_required_for_rental_income": 1,
                "rental_income": 12,
                "rental_income_currency_token_id": "",
                "rental_payment_period_in_days": 15
            },
            "created_at": "2025-10-29T00:15:50.99Z"
        }
    ],
    "total": 1,
    "page": 1,
    "per_page": 20
}

Yanıt Alanları

Alan	Tip	Açıklama
data	array	Token geçmişi kayıtlarının listesi
data[].id	string	Geçmiş kaydı için benzersiz tanımlayıcı
data[].token_id	string	Token kimliği
data[].node_id	string	İlişkili node kimliği
data[].changed_by	string	Değişikliği yapan denetçinin kimliği
data[].change_type	string	Değişiklik tipi: value_update veya metric_update
data[].change_reason	string	Değişiklik nedeni: manual_update, market_adjustment veya system_update
data[].value_change	object | null	Değer değişikliği verisi (change_type value_update olduğunda mevcut)
data[].metric_change	object | null	Metrik değişikliği verisi (change_type metric_update olduğunda mevcut)
data[].created_at	string	Değişikliğin yapıldığı ISO 8601 zaman damgası
total	integer	Toplam geçmiş kayıt sayısı
page	integer	Mevcut sayfa numarası
per_page	integer	Sayfa başına öğe sayısı

Değer Değişikliği Veri Alanları

Alan	Tip	Açıklama
total_value	object	Toplam değer bilgisi (fiyat nesnesi)
token_price	object	Token fiyat bilgisi (fiyat nesnesi)
salable_percentage	number	Satılabilir token yüzdesi
listed_supply	integer	Listelenen token sayısı

Metrik Değişikliği Veri Alanları

Alan	Tip	Açıklama
term_duration_in_months	integer | null	Token süresinin ay cinsinden süresi
min_purchase_quantity	integer	Minimum satın alma miktarı
max_purchase_quantity	integer	Maksimum satın alma miktarı
min_tokens_required_for_rental_income	integer	Kira geliri için gerekli minimum token sayısı
rental_income	number	Kira geliri miktarı
rental_income_currency_token_id	string	Kira geliri için para birimi token kimliği
rental_payment_period_in_days	integer	Kira ödeme dönemi (gün cinsinden)

Değişiklik Tipleri

Değer	Açıklama
value_update	Token değeri/fiyat bilgisi güncellemesi
metric_update	Token metrikleri güncellemesi (kira geliri, satın alma limitleri, vb.)

Değişiklik Nedenleri

Değer	Açıklama
manual_update	Denetçi tarafından manuel güncelleme
market_adjustment	Piyasa koşullarına göre otomatik ayarlama
system_update	Sistem tarafından oluşturulan güncelleme

Durum Kodları

Durum Kodu	Açıklama
200	Başarılı - Token geçmişi başarıyla getirildi
400	Hatalı İstek - Geçersiz istek parametreleri
401	Yetkisiz - Geçersiz veya eksik kimlik doğrulama token'ı
404	Bulunamadı - Token kimliği mevcut değil
500	Sunucu Hatası