Sprawdź status AML

Pobiera najnowszy status i ocenę ryzyka istniejącej weryfikacji AML. Dane są aktualizowane, gdy pojawiają się nowe informacje.

POST /v1/aml-checks/check

Żądanie

Parametry

Pole	Typ	Wymagane	Opis
id	string	Tak	Identyfikator weryfikacji AML

Bash

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

# Oblicz sygnaturę
SIGNATURE=$(echo -n "${REQUEST_BODY}${API_SECRET}" | sha256sum | cut -d' ' -f1)

# Wyślij żądanie API
curl -X POST "https://api.tronzap.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: '01jq7h6bvf6p5t1amnz6y3n8c4'
});

// Oblicz sygnaturę
const signature = crypto
  .createHash('sha256')
  .update(requestBody + apiSecret)
  .digest('hex');

// Wyślij żądanie API
axios({
  method: 'post',
  url: 'https://api.tronzap.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' => '01jq7h6bvf6p5t1amnz6y3n8c4'
]);

// Oblicz sygnaturę
$signature = hash('sha256', $requestBody . $apiSecret);

// Wyślij żądanie API
$ch = curl_init('https://api.tronzap.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': '01jq7h6bvf6p5t1amnz6y3n8c4'
})

# Oblicz sygnaturę
signature = hashlib.sha256((request_body + api_secret).encode()).hexdigest()

# Wyślij żądanie API
headers = {
  'Authorization': f'Bearer {api_token}',
  'X-Signature': signature,
  'Content-Type': 'application/json'
}

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

print(response.json())

Odpowiedź

Zwraca szczegóły weryfikacji AML z najnowszymi danymi ryzyka. Jeśli weryfikacja nadal trwa, status pozostaje pending lub processing.

Pola odpowiedzi

Pole	Typ	Opis
code	integer	Kod odpowiedzi (0 = sukces)
result	object	Dane weryfikacji AML
result.id	string	Identyfikator weryfikacji AML
result.type	string	Typ usługi AML (address lub hash)
result.address	string	Weryfikowany adres
result.hash	string	Weryfikowany hash (tylko dla weryfikacji hash)
result.direction	string	Kierunek transakcji, jeśli dotyczy
result.network	string	Kod sieci blockchain
result.status	string	Aktualny status (pending, processing, completed, failed)
result.risk_score	float	Ocena ryzyka
result.risk_level	string	Poziom ryzyka (low, medium, high)
result.blacklist	boolean	Informacja, czy wykryto wpis na liście blokad
result.risk_factors	array	Lista czynników ryzyka
result.checked_at	string	Znacznik czasu utworzenia weryfikacji (ISO 8601)

Przykładowa odpowiedź

{
  "code": 0,
  "result": {
    "id": "01jq7h6bvf6p5t1amnz6y3n8c4",
    "type": "hash",
    "address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
    "hash": "E3F2A1B66DBB9F0B24C4125229163944A7D91EB3F1AC5E409FFCEE0C81A913F2",
    "direction": "withdrawal",
    "network": "BTC",
    "status": "processing",
    "risk_score": null,
    "risk_level": null,
    "blacklist": false,
    "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-25T10:42:12Z"
  }
}

Możliwe błędy

Kod błędu	Opis
1	Błąd uwierzytelniania (nieprawidłowy token lub sygnatura)
2	Nieprawidłowe parametry
30	Weryfikacja AML nie została znaleziona
500	Wewnętrzny błąd serwera