Webhook Teslimatlarını Listele

Bir custody sağlayıcısının platforma teslim ettiği webhook'ları ve her birinin sonucunu en yeniden eskiye listeler. İstek görüntüsü (başlıklar, gövde) satırlarda yer almaz; tek bir teslimatı Webhook Teslimatını Getir ile okuyun.

Bir teslimat birden fazla satır üretebilir: her işleme tarafı kendi sonucunu kaydeder; bu yüzden bir teslimat her context (admin, user) için bir kez görünebilir. Bu satırları webhook_id birbirine bağlar.

Yalnızca platform sahibi. Çağıranın düğümü platformun kök düğümü olmalıdır; diğer çağıranlar 403 / 10005 ile reddedilir.

Gerekli izin: custodial-wallet:view

İstek

GET /v2/admin/custodial-wallets/{provider}/webhook-logs

Parametreler

Ad	Tip	Konum	Açıklama
provider	string	path	Zorunlu. Sağlayıcı anahtarı: rudiq ya da taurus
page	integer	query	Zorunlu. Sayfa numarası, 1'den başlar
per_page	integer	query	Zorunlu. Sayfa başına kayıt, 1–100
context	string	query	Yalnızca bu işleme tarafının satırları: admin ya da user
statuses	string	query	Yalnızca bu sonuçlara sahip satırlar: processed, unmatched, skipped, failed. Birden fazlası için parametreyi tekrarlayın (statuses=failed&statuses=skipped)
transaction_id	string	query	Yalnızca bu Custody Transaction ID'ye ait satırlar: custody'nin işlemi kabul ederken döndürdüğü ID

Başlıklar

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

Örnek

curl --request GET \
  --url '{{baseUrl}}/v2/admin/custodial-wallets/rudiq/webhook-logs?page=1&per_page=20&statuses=failed&statuses=skipped' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

{
  "data": [
    {
      "id": "6911c1a7e4b0f51d2c8a7f10",
      "webhook_id": "8d0c6a52-3f7e-4b19-9a2d-51e4c7b0f3a6",
      "context": "admin",
      "provider": "rudiq",
      "source_ip": "10.42.3.17",
      "transaction_id": "4c1a9b4e-0000-4000-8000-00000000abcd",
      "custody_transaction_id": "9b2e7d14-0000-4000-8000-0000000017f3",
      "gas_fee_wei": "52341000000000",
      "gas_fee_native": "0.000052341",
      "transaction_hash": "0x5b8e2f4c1d9a7b3e6f0a2c4d8e1b3f5a7c9d0e2f4a6b8c0d1e3f5a7b9c2d4e6f",
      "transaction_type": "deploy_contract",
      "transaction_status": "completed",
      "status": "processed",
      "received_at": "2026-11-09T09:41:22.508Z",
      "created_at": "2026-11-09T09:41:22.734Z"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 20
}

Yanıt Alanları

Alan	Tip	Açıklama
data	array	Bu sayfadaki teslimat satırları
data[].id	string	Satır ID'si; Webhook Teslimatını Getir uç noktasına verin
data[].webhook_id	string	Gönderenin teslimat ID'si; her işleme tarafının satırlarında ortaktır
data[].context	string	Satırı yazan işleme tarafı: admin ya da user
data[].provider	string	Sağlayıcı anahtarı
data[].source_ip	string	Teslimatın geldiği IP adresi
data[].transaction_id	string	Custody Transaction ID: custody'nin işlemi kabul ederken döndürdüğü ve platformun kendi işlemini eşleştirdiği anahtar
data[].custody_transaction_id	string	Custody'nin işlem için kendi satır ID'si. Custody göndermediyse yer almaz
data[].external_id	string	Custody'nin mutabakat ID'si. Custody göndermediyse yer almaz
data[].gas_fee_wei	string	Custody'nin ödediği gas ücreti, wei cinsinden. Custody göndermediyse yer almaz
data[].gas_fee_native	string	Custody'nin ödediği gas ücreti, ağın native para birimi cinsinden. Custody göndermediyse yer almaz
data[].transaction_hash	string	Zincir üstü işlem hash'i
data[].transaction_type	string	Custody'nin işlem tipi, olduğu gibi (ör. transfer, deploy_contract, execute_contract)
data[].transaction_status	string	Custody'nin işlem durumu, olduğu gibi
data[].status	string	Bu işleme tarafındaki sonuç: processed (eşleşti ve uygulandı), unmatched (bu tarafta ID'ye sahip işlem yok), skipped (eşleşti ama bilerek uygulanmadı, ör. zaten sonuçlanmış) ya da failed (işleme hata döndürdü)
data[].error	string	İşlemenin neden başarısız olduğu. Hata yoksa yer almaz
data[].received_at	string	Teslimatın platforma ulaştığı zaman (ISO 8601)
data[].created_at	string	Satırın yazıldığı zaman (ISO 8601)
total	integer	Filtrelere uyan satır sayısı
page	integer	İstekte gönderilen sayfa numarası
per_page	integer	İstekte gönderilen sayfa boyutu

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız (page / per_page eksik ya da aralık dışında) — details alanına bakın. Ayrıca: desteklenmeyen sağlayıcı anahtarı
403	10005	Çağıran platform sahibi değil (domain 2)

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