Kullanıcıya Göre Token Yak

Belirli bir kullanıcıya ait token'ları yakın (imha edin). Bu işlem token'ları dolaşımdan kalıcı olarak kaldırır.

Endpoint

POST /v2/users/tokens/{token_id}/users/{user_id}/burn

Headers

Header	Değer
Content-Type	application/json
Authorization	Bearer {token}

Yol Parametreleri

Parametre	Tip	Gerekli	Açıklama
token_id	string	Evet	Yakılacak token'ın benzersiz tanımlayıcısı
user_id	string	Evet	Token'ları yakılacak kullanıcının benzersiz tanımlayıcısı

İstek Gövdesi

İstek gövdesi gerekmez. Kullanıcı ID ve Token ID yoldan gönderilir.

Yanıt

Yakma işlemi başarıyla başlatıldığında 200 OK ve içerik olmadan döner. Yakma işlemi asenkron olarak gerçekleştirilir.

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

İçerik yok - başarılı yanıt.

Örnek

İstek

curl -X POST "\{\{baseUrl\}\}/v2/users/tokens/68aeb272d9336c619ce249f6/users/680c02896d91ca0145cfeb81/burn" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer \{\{token\}\}"

Yanıt

200 OK
(İçerik yok)

Hata Yanıtları

400 Bad Request

{
    "error": "Geçersiz parametreler",
    "details": "Miktar 0'dan büyük olmalı"
}

401 Unauthorized

{
    "error": "Kimlik doğrulaması gerekli"
}

403 Forbidden

{
    "error": "Erişim reddedildi",
    "details": "Token yakma için yetersiz izin"
}

404 Not Found

{
    "error": "Kaynak bulunamadı",
    "details": "Token veya kullanıcı bulunamadı"
}

422 Unprocessable Entity

{
    "error": "Yetersiz token bakiyesi",
    "details": "Kullanıcının yakacak kadar token'ı yok"
}

500 Internal Server Error

{
    "error": "İç sunucu hatası"
}

Önemli Notlar

• Geri Alınamaz İşlem: Token yakma kalıcıdır ve geri alınamaz
• Bakiye Kontrolü: Sistem, yakmadan önce kullanıcının yeterli token bakiyesine sahip olduğunu doğrular
• İşlem Kaydı: Tüm yakma işlemleri blockchain'de kaydedilir
• İzinler: Sadece yetkili kullanıcılar yakma işlemleri gerçekleştirebilir
• Denetim İzi: Tüm yakma işlemleri denetim amaçları için kaydedilir