Satın Alma Miktarını Getir

Kullanıcının bir token'dan ne kadar tuttuğunu ve o token'ın kullanıcı başına elde tutma sınırını döndürür. Birincil piyasa alımından önce kullanın: Birincil Piyasadan Satın Al, kullanıcının elindeki miktarı max_allowed_quantity üzerine çıkaracak alımı reddeder.

Gerekli izin: purchase:view

İstek

GET /v2/users/{user_id}/purchases/tokens/{token_id}/quantity

Parametreler

Ad	Tip	Konum	Açıklama
user_id	string	path	Zorunlu. Kullanıcı ID'si
token_id	string	path	Zorunlu. Token ID'si

Başlıklar

Ad	Açıklama
Authorization	Zorunlu. Bearer <access_token>

Örnek

curl --request GET \
  --url '{{baseUrl}}/v2/users/680c02896d91ca0145cfeb81/purchases/tokens/68ae06cfcccf4e8fc19362d1/quantity' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

{
  "purchased_quantity": 25,
  "max_allowed_quantity": 100
}

Yanıt Alanları

Alan	Tip	Açıklama
purchased_quantity	integer	Kullanıcının token'dan hâlâ elinde tuttuğu miktar (alınan eksi satılan). Hiç yoksa 0
max_allowed_quantity	integer	Token'ın kullanıcı başına elde tutma sınırı (metric.max_purchase_quantity). 0 sınır yok demektir

Hatalar

Durum	Kod	Açıklama
400	10001	Token bulunamadı (domain 5). token_id geçerli bir ID olmadığında da döner
400	10016	user_id geçerli 24 karakterlik hex ID değil
500	10000	Beklenmeyen sunucu hatası

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