Kullanıcı İşlemini Getir

Bir kullanıcının işlemlerinden birini okur. Buy On Primary Market, Buy On Secondary Market, Sell On Secondary Market, Delist, Sell On OTC, Cancel OTC Deal, Burn ve Para Çekme çağrılarının döndürdüğü transaction_id için sorgulama hedefidir.

status şu sırayla ilerler: 1 Started → 2 InProgress → 3 Done ya da 4 Error. hash Done olunca, error Error olunca dolar. Kullanıcı anahtarın parçasıdır: başka bir kullanıcıyla eşleştirilen işlem ID'si "bulunamadı" yanıtı alır.

Gerekli izin: user:view

İstek

GET /v2/users/{user_id}/transactions/{transaction_id}

Parametreler

Ad	Tip	Konum	Açıklama
user_id	string	path	Zorunlu. İşlemin ait olduğu kullanıcı (24 karakterlik hex)
transaction_id	string	path	Zorunlu. İşlem ID'si (24 karakterlik hex)

Başlıklar

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

Örnek

curl --request GET \
  --url '{{baseUrl}}/v2/users/6a87455ad5f439809d488ac3/transactions/6a8b5e13f9129816a6cc7a12' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

{
  "id": "6a8b5e13f9129816a6cc7a12",
  "user_id": "6a87455ad5f439809d488ac3",
  "type": 10,
  "status": 3,
  "environment": 0,
  "internal_id": "",
  "wallet_id": "6a8754e187be1d0e22aa6d83",
  "external_id": "",
  "hash": "0x9f2c1b6a0d4e3b7c2f1a8e5d4c3b2a1908f7e6d5c4b3a2918f7e6d5c4b3a2918",
  "error": null,
  "message": null,
  "data": {
    "address": "0x4A096E485281DE1B8bF11A511D39d5B128EF7C4b",
    "amount": "10.5",
    "currency_token_id": "6913307ec95e268b239b2d8b"
  },
  "is_api": true,
  "created_at": "2026-08-23T17:43:31.004Z",
  "updated_at": "2026-08-23T17:44:01.220Z"
}

Yanıt Alanları

Nesne, Kullanıcı İşlemlerini Getir satırlarıyla aynı alanlara sahiptir; tip, durum ve ortam değerleri ile tipe göre data anahtarları orada listelenir.

Alan	Tip	Açıklama
id	string	İşlem ID'si
user_id	string	İşlemin ait olduğu kullanıcı
type	integer	İşlemin ne yaptığı, bkz. tipler
status	integer	1 Started, 2 InProgress, 3 Done, 4 Error
environment	integer	0 Varsayılan, 1 OTC, 2 İkincil piyasa
internal_id	string	İşlemin üzerinde çalıştığı kayıt (ilan, OTC teklifi, token). Yoksa boş string
wallet_id	string	İşlemin üzerinde çalıştığı ve imzaladığı cüzdan. Cüzdan belirtmeyen işlemlerde boş string
external_id	string	Varsa custody tarafındaki referans
hash	string | null	Zincir üstü işlem hash'i; Done olunca dolar
error	string | null	Hata sebebi; Error olunca dolar
message	string | null	Verilmişse okunabilir açıklama
data	object	Tipe özel veri. İşlemin verisi yoksa alan hiç gelmez
is_api	boolean	Aksiyonun partner API üzerinden gelip gelmediği
created_at	string	ISO 8601 oluşturulma zamanı
updated_at	string	ISO 8601 son değişiklik zamanı

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama hatası (user_id ya da transaction_id 24 hex karakter değil) — details alanına bakın
400	10001	İşlem bulunamadı ya da başka bir kullanıcıya ait (domain 8)

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