AML geçmişini al

Kimliği doğrulanmış kullanıcı tarafından oluşturulan AML kontrollerinin sayfalandırılmış listesini döndürür. Duruma göre filtreleyerek sonuçları daraltabilirsiniz.

POST /v1/aml-checks/history

İstek

Parametreler

Alan	Tür	Zorunlu	Açıklama
page	integer	Hayır	Sayfa numarası (varsayılan: 1, minimum: 1)
per_page	integer	Hayır	Sayfa başına öğe sayısı (varsayılan: 10, aralık: 1-50)
status	string	Hayır	AML durumuna göre filtrele (aşağıdaki tablo)

Durum değerleri

Değer	Açıklama
pending	Kontrol oluşturuldu ve işlenmeyi bekliyor
processing	Kontrol işleniyor
completed	Kontrol başarıyla tamamlandı
failed	Kontrol hata nedeniyle tamamlanamadı
expired	Kontrolün süresi, sonuç alınmadan doldu
skipped	Kontrol çalıştırılmadı ve ücret alınmadı (ör. zincir üzerinde hiç etkinliği olmayan bir adres); risk kararı içermez

Filtre processing ve expired değerlerini kabul eder, ancak kontroller şu anda yalnızca pending, completed, skipped veya failed olarak kaydedilir.

Bash

#!/bin/bash
API_TOKEN="your_api_token"
API_SECRET="your_api_secret"
REQUEST_BODY='{
  "page": 1,
  "per_page": 10,
  "status": "completed"
}'

# İmzayı hesapla
SIGNATURE=$(echo -n "${REQUEST_BODY}${API_SECRET}" | sha256sum | cut -d' ' -f1)

# API isteği gönder
curl -X POST "https://api.trxup.com/v1/aml-checks/history" \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -H "X-Signature: ${SIGNATURE}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}"

Node.js

const crypto = require('crypto');
const axios = require('axios');

const apiToken = 'your_api_token';
const apiSecret = 'your_api_secret';
const requestBody = JSON.stringify({
  page: 1,
  per_page: 10,
  status: 'completed'
});

// İmzayı hesapla
const signature = crypto
  .createHash('sha256')
  .update(requestBody + apiSecret)
  .digest('hex');

// API isteği gönder
axios({
  method: 'post',
  url: 'https://api.trxup.com/v1/aml-checks/history',
  headers: {
    'Authorization': `Bearer ${apiToken}`,
    'X-Signature': signature,
    'Content-Type': 'application/json'
  },
  data: requestBody
})
.then(response => console.log(response.data))
.catch(error => console.error(error));

PHP

<?php
$apiToken = 'your_api_token';
$apiSecret = 'your_api_secret';
$requestBody = json_encode([
  'page' => 1,
  'per_page' => 10,
  'status' => 'completed'
]);

// İmzayı hesapla
$signature = hash('sha256', $requestBody . $apiSecret);

// API isteği gönder
$ch = curl_init('https://api.trxup.com/v1/aml-checks/history');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $requestBody);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'Authorization: Bearer ' . $apiToken,
  'X-Signature: ' . $signature,
  'Content-Type: application/json'
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

Python

import hashlib
import json
import requests

api_token = 'your_api_token'
api_secret = 'your_api_secret'
request_body = json.dumps({
  'page': 1,
  'per_page': 10,
  'status': 'completed'
})

# İmzayı hesapla
signature = hashlib.sha256((request_body + api_secret).encode()).hexdigest()

# API isteği gönder
headers = {
  'Authorization': f'Bearer {api_token}',
  'X-Signature': signature,
  'Content-Type': 'application/json'
}

response = requests.post(
  'https://api.trxup.com/v1/aml-checks/history',
  headers=headers,
  data=request_body
)

print(response.json())

Yanıt

Yanıt sayfalama metaverileriyle birlikte diğer endpoint'lerle aynı formatta AML kontrollerini içerir.

Yanıt alanları

Alan	Tür	Açıklama
code	integer	Yanıt kodu (0 = başarı)
request_id	string	Benzersiz istek tanımlayıcısı
result	object	Sayfalandırılmış sonuç
result.page	integer	Mevcut sayfa numarası
result.per_page	integer	Sayfa başına dönen öğe sayısı
result.total	integer	Filtredeki toplam AML kontrol sayısı
result.items	array	AML kontrol kayıtları
result.items[].id	string	AML kontrol kimliği
result.items[].type	string	AML servis türü (address veya hash)
result.items[].address	string	İncelenen adres
result.items[].network	string	Desteklenen ağlar listesinde yazıldığı biçimiyle blockchain ağ kodu (ör. TRX, TetherOMNI)
result.items[].status	string	Güncel durum (pending, processing, completed, failed, expired, skipped)
result.items[].risk_score	string|null	Risk skoru; iki ondalık basamaklı bir dize (ör. "12.50") veya henüz skor yoksa null
result.items[].risk_level	string|null	Risk seviyesi (low, medium, high)
result.items[].blacklist	boolean	Kara liste eşleşmesi olup olmadığını gösterir
result.items[].risk_factors	array	Fonların bağlantılı olduğu risk kategorileri; score değerine göre büyükten küçüğe sıralı, kategori başına bir kayıt; hiçbir kategori bildirilmediyse boş [] (ör. kontrol henüz tamamlanmadıysa)
result.items[].risk_factors[].name	string	Kategori anahtarı; Risk faktörü kategorileri bölümünde listelenen anahtarlardan biri; bu listenin dışındaki bir kategori other olarak bildirilir
result.items[].risk_factors[].label	string	Kategorinin İngilizce adı (çevrilmez)
result.items[].risk_factors[].group	string	Kategorinin risk grubu: low, medium veya high
result.items[].risk_factors[].score	number	Fonların bu kategoriyle bağlantılı payı; 0 ile 1 arasında, 3 ondalık basamağa yuvarlanmış
result.items[].checked_at	string	Kontrolün oluşturulma zamanı (ISO 8601)
result.items[].hash	string	İncelenen hash (yalnızca hash)
result.items[].direction	string	İşlemin incelenen tarafı, deposit veya withdrawal (yalnızca hash)

Kategori anahtarlarının adları ve gruplarıyla birlikte tam listesi Risk faktörü kategorileri bölümündedir.

Yanıt örneği

{
  "code": 0,
  "request_id": "bbf74bcd-fb36-4df8-adc8-25f2bacd087b",
  "result": {
    "page": 1,
    "per_page": 2,
    "total": 5,
    "items": [
      {
        "id": "1042",
        "type": "hash",
        "address": "TPY1Kb8cKAZQfm95gXQQs2Mh8Uygtos21D",
        "network": "TRX",
        "status": "completed",
        "risk_score": "64.30",
        "risk_level": "high",
        "blacklist": true,
        "risk_factors": [],
        "checked_at": "2024-03-25T11:14:48+00:00",
        "hash": "E3F2A1B66DBB9F0B24C4125229163944A7D91EB3F1AC5E409FFCEE0C81A913F2",
        "direction": "withdrawal"
      },
      {
        "id": "1041",
        "type": "address",
        "address": "TPY1Kb8cKAZQfm95gXQQs2Mh8Uygtos21D",
        "network": "TRX",
        "status": "pending",
        "risk_score": null,
        "risk_level": null,
        "blacklist": false,
        "risk_factors": [],
        "checked_at": "2024-03-25T11:12:03+00:00"
      }
    ]
  }
}

Olası hatalar

Hata kodu	Key	Açıklama
1	auth	Kimlik doğrulama hatası (geçersiz token veya imza)
2	invalid_service_or_params	Geçersiz sayfalama veya durum parametreleri
500	internal_server_error	Sunucu hatası