Token İşlemlerini Listele

Bir token'ın zincir üstü işlemlerinden bir sayfayı en yeniden eskiye döndürür; isteğe bağlı olarak tek bir işlem tipine daraltılabilir. Her asenkron token uç noktası başlattığı işlemin id'sini döner; o işlemi ID ile Token İşlemi Getir ile sorgulayın. Bu listeyi, bir çağrının başlatıp döndürmediği işlemler (Token'ı Listele ve Token Güncelle uç noktalarının AddDocumentToToken işlemleri) ve token'ın işlem geçmişi için kullanın.

Gerekli izin: token:transactions:view

İstek

GET /v2/admin/tokens/{token_id}/transactions?page=1&per_page=20

Parametreler

Ad	Tip	Konum	Açıklama
token_id	string	path	Zorunlu. Token id'si.
page	integer	query	Zorunlu. Sayfa numarası, 1'den başlar.
per_page	integer	query	Zorunlu. Sayfa boyutu, 1 ile 100 arası.
type	integer	query	İsteğe bağlı. Yalnızca bu işlem tipi (bkz. type Enum).

Başlıklar

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

Örnek

curl --request GET \
  --url '{{baseUrl}}/v2/admin/tokens/67d8774e903bfcbe7eb5d93e/transactions?page=1&per_page=20&type=16' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

{
  "data": [
    {
      "id": "67d8774f903bfcbe7eb5d941",
      "node_id": "67d6c447f47ff3adafda700d",
      "user_id": "",
      "token_id": "67d8774e903bfcbe7eb5d93e",
      "hash": "0x998a217061da05cf1bf1998470613a488b10908f0964e76a123c4063f91d77c4",
      "type": 16,
      "status": 3,
      "error": null,
      "is_api": true,
      "created_at": "2025-03-17T19:26:07.042Z"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 20
}

Yanıt Alanları

Alan	Tip	Açıklama
data[].id	string	İşlem id'si.
data[].node_id	string	Token'ın düğümü.
data[].user_id	string	Token işlemlerinde doldurulmaz: her zaman "".
data[].token_id	string	Token id'si.
data[].hash	string | null	İşlem gönderildiğinde zincir üstü işlem hash'i.
data[].type	integer	İşlem tipi, bkz. type Enum.
data[].status	integer	Yaşam döngüsü durumu, bkz. status Enum.
data[].error	string | null	status 4 (Error) olduğunda başarısızlık nedeni.
data[].is_api	boolean	İşlem, yönetim panelindeki bir supervisor'dan değil, partner API üzerinden bir API istemcisinden geldi.
data[].created_at	string	Oluşturulma zamanı (RFC 3339).
total	integer	Eşleşen işlem sayısı.
page	integer	İstekte gönderilen sayfa numarası.
per_page	integer	İstekte gönderilen sayfa boyutu.

type Enum

Değer	Ad	Başlatan
1	CreateTokenization	Token Oluştur, Token'ı Yeniden Tokenize Et
2	TokenListing	Token'ı Listele
3	TokenRent	Kira Geliri Dağıt
4	UpdateTokenSupply	Partner API tarafından başlatılmaz
5	UpdateToken	Token Güncelle, Token Metriğini Güncelle
6	DelistToken	Token Listelemesini Kaldır
7	PassiveToken	Token'ı Pasife Al
8	PublicTransferToken	Token Genel Transferi
9	ChangeTokenLaunchpadAddress	Partner API tarafından başlatılmaz
10	BurnToken	Token Yak
11	OpenToSecondaryMarket	Token'ı İkincil Piyasaya Aç
12	OpenToOtc	Token'ı OTC'ye Aç
13	AcceptOtcOffer	Bir OTC teklifinin kabulü
14	CancelOtcOffer	Bir OTC teklifinin iptali
15	UpdateRulesOnSecondaryMarket	İkincil piyasa kural güncellemeleri
16	AddDocumentToToken	Token'ı Listele, Token Güncelle (zincire yazılan her belge için bir tane)
17	DeployTokenImpl	ERC-3643 dağıtım adımı
18	DeployMCImpl	ERC-3643 dağıtım adımı
19	DeployTREXAuthority	ERC-3643 dağıtım adımı
20	TREXAddAndUseVersion	ERC-3643 dağıtım adımı
21	DeployMCProxy	ERC-3643 dağıtım adımı
22	DeployTokenProxy	ERC-3643 dağıtım adımı
23	DeployERC4380Impl	ERC-4380 dağıtım adımı
24	DeployERC4380Proxy	ERC-4380 dağıtım adımı

Yeni tipler eklenebilir. Bilinmeyen bir değeri hata olarak değil "diğer işlem" olarak ele alın.

status Enum

Değer	Ad	Anlamı
1	Started	Kuyrukta, henüz alınmadı.
2	InProgress	Hazırlanıyor ve imzalanıyor.
3	Done	Zincirde onaylandı. hash dolu.
4	Error	Başarısız. Nedeni error alanında.
5	PendingReceipt	Gönderildi (hash dolu), makbuz bekleniyor. 3 ya da 4 ile biter.

1, 2 ve 5 nihai değildir. Yalnızca 3 başarı, yalnızca 4 başarısızlıktır.

Sorgulama Düzeni

1. İşlemi çağırın (örneğin Token'ı Listele) ve döndüğü transaction_id değerini saklayın.
2. status 3 (Done) ya da 4 (Error) olana kadar birkaç saniyede bir ID ile Token İşlemi Getir ile sorgulayın.
3. 3 olduğunda token'ı yeniden okuyun: durumu ve bayrakları işlem sonuçlandığında değişir. 4 olduğunda error alanını okuyun.
4. Bir çağrının döndürmediği işlemleri (AddDocumentToToken, tip 16) burada type=16 ile listeleyin.

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız (page ya da per_page eksik veya aralık dışı) — details alanına bakın
400	10016	token_id geçerli bir id değil
400	10001	Token bulunamadı (token domain'i 5)
403	10005	Çağıranın düğümü token'ın düğümünü kapsamıyor (düğüm domain'i 2)

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