Проверить статус AML

Получает актуальный статус и оценку риска для существующей AML-проверки. Данные обновляются при появлении новой информации.

POST /v1/aml-checks/check

Запрос

Параметры

Поле	Тип	Обязательное	Описание
id	string	Да	Идентификатор AML-проверки

Bash

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

# Подпись
SIGNATURE=$(echo -n "${REQUEST_BODY}${API_SECRET}" | sha256sum | cut -d' ' -f1)

# Запрос
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'
});

// Подпись
const signature = crypto
  .createHash('sha256')
  .update(requestBody + apiSecret)
  .digest('hex');

// Запрос
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'
]);

// Подпись
$signature = hash('sha256', $requestBody . $apiSecret);

// Запрос
$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'
})

# Подпись
signature = hashlib.sha256((request_body + api_secret).encode()).hexdigest()

# Запрос
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())

Ответ

Возвращает данные AML-проверки с актуальной оценкой риска. Если проверка еще выполняется, статус остается pending или processing.

Поля ответа

Поле	Тип	Описание
code	integer	Код ответа (0 = успех)
result	object	Данные AML-проверки
result.id	string	Идентификатор AML-проверки
result.type	string	Тип AML-сервиса (address или hash)
result.address	string	Проверяемый адрес
result.hash	string	Проверяемый хеш (только для hash)
result.direction	string	Направление транзакции, если применимо
result.network	string	Код сети блокчейн
result.status	string	Текущий статус (pending, processing, completed, failed)
result.risk_score	float	Риск-балл
result.risk_level	string	Уровень риска (low, medium, high)
result.blacklist	boolean	Показывает, найдено ли совпадение с черными списками
result.risk_factors	array	Список факторов риска
result.checked_at	string	Время создания проверки (ISO 8601)

Пример ответа

{
  "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"
  }
}

Возможные ошибки

Код ошибки	Описание
1	Ошибка аутентификации (неверный токен или подпись)
2	Некорректные параметры
30	AML-проверка не найдена
500	Внутренняя ошибка сервера