Consultar status AML

Recupera o status mais recente e a avaliação de risco de uma verificação AML existente. Os dados são atualizados assim que novas informações ficam disponíveis.

POST /v1/aml-checks/check

Requisição

Parâmetros

Campo	Tipo	Obrigatório	Descrição
id	string	Sim	Identificador da verificação AML

Bash

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

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

# Chamada à 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'
});

// Calcular assinatura
const signature = crypto
  .createHash('sha256')
  .update(requestBody + apiSecret)
  .digest('hex');

// Chamada à 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'
]);

// Calcular assinatura
$signature = hash('sha256', $requestBody . $apiSecret);

// Chamada à 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'
})

# Calcular assinatura
signature = hashlib.sha256((request_body + api_secret).encode()).hexdigest()

# Chamada à 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())

Resposta

Retorna os detalhes da verificação AML com os dados de risco mais recentes. Se a verificação ainda estiver em andamento, o status permanece pending ou processing.

Campos da resposta

Campo	Tipo	Descrição
code	integer	Código de resposta (0 = sucesso)
request_id	string	Identificador único da requisição
result	object	Dados da verificação AML
result.id	string	Identificador da verificação AML
result.type	string	Tipo de serviço AML (address ou hash)
result.address	string	Endereço analisado
result.hash	string	Hash analisado (apenas para hash)
result.direction	string|null	Direção da transação quando aplicável
result.network	string	Código da rede blockchain
result.status	string	Status atual (pending, processing, completed, failed)
result.risk_score	string|null	Pontuação de risco
result.risk_level	string|null	Nível de risco textual (low, medium, high)
result.blacklist	boolean	Indica se há correspondência em listas de bloqueio
result.risk_factors	array	Lista de fatores de risco
result.checked_at	string	Timestamp de criação da verificação (ISO 8601)

Exemplo de resposta

{
  "code": 0,
  "request_id": "bbf74bcd-fb36-4df8-adc8-25f2bacd087b",
  "result": {
    "id": "01jq7h6bvf6p5t1amnz6y3n8c4",
    "type": "address",
    "address": "0x6Dc1f03B1d2c27D6c741832F4AA83322D41De7Ea",
    "network": "ETH",
    "status": "completed",
    "risk_score": "12.5",
    "risk_level": "medium",
    "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"
  }
}

Possíveis erros

Código de erro	Key	Descrição
1	auth	Erro de autenticação (token ou assinatura incorretos)
2	invalid_service_or_params	Parâmetros inválidos
30	aml_check_not_found	Verificação AML não encontrada
500	internal_server_error	Erro interno do servidor