AML durumunu kontrol et

Var olan bir AML kontrolü için en güncel durum ile risk değerlendirmesini döndürür. Yeni bilgiler geldikçe veri otomatik olarak güncellenir.

POST /v1/aml-checks/check

İstek

Parametreler

Alan	Tür	Zorunlu	Açıklama
id	string	Evet	AML kontrol kimliği

Bash

#!/bin/bash
API_TOKEN="your_api_token"
API_SECRET="your_api_secret"
REQUEST_BODY='{
  "id": "1042"
}'

# İ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/check" \
  -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({
  id: '1042'
});

// İ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/check',
  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([
  'id' => '1042'
]);

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

// API isteği gönder
$ch = curl_init('https://api.trxup.com/v1/aml-checks/check');
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({
  'id': '1042'
})

# İ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/check',
  headers=headers,
  data=request_body
)

print(response.json())

Yanıt

AML kontrolüne ait en son risk verilerini döndürür. Kontrol hâlâ pending durumundaysa sunucu yanıt vermeden önce sonucu yeniden sorgular, böylece her çağrı en güncel durumu döndürür; durum değişene kadar sorgulamaya devam edin.

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	AML kontrol verileri
result.id	string	AML kontrol kimliği
result.type	string	AML servis türü (address veya hash)
result.address	string	İncelenen adres
result.network	string	Desteklenen ağlar listesinde yazıldığı biçimiyle blockchain ağ kodu (ör. TRX, TetherOMNI)
result.status	string	Güncel durum (pending, processing, completed, failed, expired, skipped)
result.risk_score	string|null	Risk skoru; iki ondalık basamaklı bir dize (ör. "12.50") veya henüz skor yoksa null
result.risk_level	string|null	Risk seviyesi (low, medium, high)
result.blacklist	boolean	Kara listede eşleşme olup olmadığını gösterir
result.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.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.risk_factors[].label	string	Kategorinin İngilizce adı (çevrilmez)
result.risk_factors[].group	string	Kategorinin risk grubu: low, medium veya high
result.risk_factors[].score	number	Fonların bu kategoriyle bağlantılı payı; 0 ile 1 arasında, 3 ondalık basamağa yuvarlanmış
result.checked_at	string	Kontrolün oluşturulma zamanı (ISO 8601)
result.hash	string	İncelenen hash (yalnızca hash)
result.direction	string	İşlemin incelenen tarafı, deposit veya withdrawal (yalnızca hash)

Risk faktörü kategorileri

risk_factors[].name her zaman bu anahtarlardan biridir. Bu listenin dışındaki bir kategori other olarak bildirilir. label her zaman İngilizcedir: yanıtın bir parçasıdır, çeviri değildir.

name	label	group
enforcement_action	Enforcement Action	high
ransom	Ransom	high
dark_market	Dark Market	high
dark_service	Dark Service	high
illegal_service	Illegal Service	high
mixer	Mixer	high
scam	Scam	high
gambling	Gambling	high
stolen_coins	Stolen Coins	high
exchange_fraudulent	Fraudulent Exchange	high
child_exploitation	Child Exploitation	high
sanctions	Sanctions	high
terrorism_financing	Terrorism Financing	high
malware	Malware	high
infrastructure_as_a_service	Infrastructure-as-a-Service	medium
decentralized_exchange_contract	Decentralized Exchange Contract	medium
unnamed_service	Unnamed Service	medium
atm	ATM	medium
risky_exchange	Risky Exchange	medium
p2p_exchange_mlrisk_high	P2P Exchange (High Risk)	medium
liquidity_pools	Liquidity Pools	medium
exchange	Exchange	low
merchant_services	Merchant Services	low
wallet	Wallet	low
miner	Miner	low
payment	Payment	low
marketplace	Marketplace	low
p2p_exchange	P2P Exchange	low
seized_assets	Seized Assets	low
other	Other	low

Yanıt örneği

{
  "code": 0,
  "request_id": "bbf74bcd-fb36-4df8-adc8-25f2bacd087b",
  "result": {
    "id": "1042",
    "type": "address",
    "address": "TPY1Kb8cKAZQfm95gXQQs2Mh8Uygtos21D",
    "network": "TRX",
    "status": "completed",
    "risk_score": "12.50",
    "risk_level": "medium",
    "blacklist": false,
    "risk_factors": [
      {
        "name": "exchange",
        "label": "Exchange",
        "group": "low",
        "score": 0.9
      },
      {
        "name": "p2p_exchange_mlrisk_high",
        "label": "P2P Exchange (High Risk)",
        "group": "medium",
        "score": 0.1
      }
    ],
    "checked_at": "2024-03-25T10:42:12+00:00"
  }
}

Hash kontrolünde hash ve direction alanları checked_at alanından sonra gelir:

{
  "code": 0,
  "request_id": "bbf74bcd-fb36-4df8-adc8-25f2bacd087b",
  "result": {
    "id": "1043",
    "type": "hash",
    "address": "TPY1Kb8cKAZQfm95gXQQs2Mh8Uygtos21D",
    "network": "TRX",
    "status": "completed",
    "risk_score": "3.20",
    "risk_level": "low",
    "blacklist": false,
    "risk_factors": [],
    "checked_at": "2024-03-25T10:44:31+00:00",
    "hash": "E3F2A1B66DBB9F0B24C4125229163944A7D91EB3F1AC5E409FFCEE0C81A913F2",
    "direction": "deposit"
  }
}

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 parametreler (id eksik veya boş)
30	aml_check_not_found	AML kontrolü bulunamadı veya başka bir hesaba ait
500	internal_server_error	Sunucu hatası