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ı

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.tronzap.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.tronzap.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.tronzap.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.tronzap.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ı)
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[].hash	string	İncelenen hash (yalnızca hash)
result.items[].direction	string	İşlem yönü gerektiğinde
result.items[].network	string	Blockchain ağ kodu
result.items[].status	string	Güncel durum (pending, processing, completed, failed)
result.items[].risk_score	float	Risk skoru
result.items[].risk_level	string	Risk seviyesi (low, medium, high)
result.items[].blacklist	boolean	Kara liste eşleşmesi olup olmadığını gösterir
result.items[].risk_factors	array	Risk faktörleri listesi
result.items[].checked_at	string	Kontrolün oluşturulma zamanı (ISO 8601)

Yanıt örneği

{
  "code": 0,
  "result": {
    "page": 1,
    "per_page": 2,
    "total": 5,
    "items": [
      {
        "id": "01jq7h6bvf6p5t1amnz6y3n8c4",
        "type": "hash",
        "address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
        "hash": "E3F2A1B66DBB9F0B24C4125229163944A7D91EB3F1AC5E409FFCEE0C81A913F2",
        "direction": "withdrawal",
        "network": "BTC",
        "status": "completed",
        "risk_score": 64.3,
        "risk_level": "high",
        "blacklist": true,
        "risk_factors": [
          {
            "name": "p2p_exchange_mlrisk_high",
            "label": "P2P Exchange (High Risk)",
            "group": "medium",
            "score": 0.796
          },
          {
            "name": "exchange",
            "label": "Exchange",
            "group": "low",
            "score": 0.203
          }
        ],
        "checked_at": "2024-03-25T11:14:48Z"
      },
      {
        "id": "01jq7g0r7w1r6b2fayq5e4n9d7",
        "type": "address",
        "address": "0x6Dc1f03B1d2c27D6c741832F4AA83322D41De7Ea",
        "network": "ETH",
        "status": "pending",
        "risk_score": null,
        "risk_level": null,
        "blacklist": false,
        "risk_factors": [],
        "checked_at": "2024-03-25T11:12:03Z"
      }
    ]
  }
}

Olası hatalar

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