ID ile Token İşlemi Getir
Bir token'ın tek bir işlemini döndürür. Her asenkron token uç noktasından sonra sorgulanacak okuma budur: uç noktanın döndüğü transaction_id ile status 3 (Done) ya da 4 (Error) olana kadar çağırın. Başka bir token'a ait işlem bulunamadı olarak raporlanır.
Gerekli izin: token:transactions:view
İstek
GET /v2/admin/tokens/{token_id}/transactions/{transaction_id}
Parametreler
| Ad | Tip | Konum | Açıklama |
|---|---|---|---|
token_id | string | path | Zorunlu. Token id'si. |
transaction_id | string | path | Zorunlu. İşlem id'si. |
Başlıklar
| Ad | Açıklama |
|---|---|
Authorization | Zorunlu. Bearer <access_token> |
Örnek
curl --request GET \
--url '{{baseUrl}}/v2/admin/tokens/67d8774e903bfcbe7eb5d93e/transactions/6a8b5e13f9129816a6cc7a12' \
--header 'Authorization: Bearer <access_token>'
Yanıt
{
"id": "6a8b5e13f9129816a6cc7a12",
"node_id": "67d6c447f47ff3adafda700d",
"supervisor_id": "665b372f3a72d7d0791596ba",
"token_id": "67d8774e903bfcbe7eb5d93e",
"network_id": "6740e0a20000000000000103",
"external_id": "c3f1a9e2-7d4b-4c55-9b1e-2a6f0d8e4b17",
"correlation_id": "4f9c2d1e-8a7b-4c3d-9e2f-1a0b9c8d7e6f",
"data": {
"is_open_to_otc": true
},
"environment": 0,
"type": 12,
"status": 3,
"triggered": 0,
"hash": "0x998a217061da05cf1bf1998470613a488b10908f0964e76a123c4063f91d77c4",
"error": null,
"message": null,
"is_api": false,
"updated_at": "2025-03-17T19:26:42.180Z",
"created_at": "2025-03-17T19:26:07.042Z"
}
Yanıt Alanları
| Alan | Tip | Açıklama |
|---|---|---|
id | string | İşlem id'si. |
node_id | string | Token'ın düğümü. |
supervisor_id | string | İşlemi başlatan supervisor. Bir API istemcisi başlattıysa yer almaz. |
token_id | string | Token id'si. |
network_id | string | İşlemin çalıştığı ağ (token'ın ağı). |
external_id | string | Custody cüzdan çağrısının istek id'si. |
correlation_id | string | İşlemi oluşturan akışın id'si; isteği, olayları ve sonuçlanması bu id'yi paylaşır. Eski kayıtlarda yer almaz. |
data | object | null | Tipe özgü değerler; örneğin AddDocumentToToken için document_id, piyasa bayrakları için istenen bayrak (is_public, is_open_to_otc, is_open_to_secondary_market). |
environment | integer | 0 varsayılan, 1 OTC, 2 ikincil piyasa. |
type | integer | İşlem tipi, bkz. type Enum. |
status | integer | 1 Started, 2 InProgress, 3 Done, 4 Error, 5 PendingReceipt. Bkz. status Enum. |
triggered | integer | 0 bir istekle başlatıldı, 1 sistem tarafından (zamanlanmış bir iş) başlatıldı. |
hash | string | null | İşlem gönderildiğinde zincir üstü işlem hash'i. |
error | string | null | status 4 olduğunda başarısızlık nedeni. |
message | string | null | İşleme sırasında eklenen bilgi mesajı. |
is_api | boolean | İşlem partner API üzerinden bir API istemcisinden geldi. |
updated_at | string | Son değişiklik (RFC 3339). |
created_at | string | Oluşturulma zamanı (RFC 3339). |
Bu okuma, Token İşlemlerini Listele satırından daha fazla alan döndürür.
Hatalar
| Durum | Kod | Açıklama |
|---|---|---|
| 400 | 10016 | token_id ya da transaction_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) |
| 400 | 10001 | İşlem bulunamadı ya da başka bir token'a ait (token işlemi domain'i 8) |
Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.