Obtener historial AML

Recupere una lista paginada de las verificaciones AML creadas por el usuario autenticado. Use filtros para limitar por estado.

POST /v1/aml-checks/history

Solicitud

Parámetros

Campo	Tipo	Requerido	Descripción
page	integer	No	Número de página (predeterminado: 1, mínimo: 1)
per_page	integer	No	Elementos por página (predeterminado: 10, rango: 1-50)
status	string	No	Filtrar por estado AML (ver tabla)

Valores de estado

Valor	Descripción
pending	Verificación creada y a la espera de procesarse
processing	Verificación en curso
completed	Verificación finalizada con éxito
failed	Verificación fallida por errores

Bash

#!/bin/bash
API_TOKEN="your_api_token"
API_SECRET="your_api_secret"
REQUEST_BODY='{
  "page": 1,
  "per_page": 10,
  "status": "completed"
}'

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

# Realizar solicitud a la API
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'
});

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

// Realizar solicitud a la API
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'
]);

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

// Realizar solicitud a la API
$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'
})

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

# Realizar solicitud a la API
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())

Respuesta

La respuesta incluye los datos de paginación junto con las verificaciones AML en el mismo formato que los endpoints individuales.

Campos de la respuesta

Campo	Tipo	Descripción
code	integer	Código de respuesta (0 = éxito)
result	object	Resultado paginado
result.page	integer	Número de página
result.per_page	integer	Número de elementos devueltos
result.total	integer	Total de verificaciones para el filtro
result.items	array	Conjunto de objetos de verificación AML
result.items[].id	string	Identificador de la verificación AML
result.items[].type	string	Tipo de servicio AML (address o hash)
result.items[].address	string	Dirección analizada
result.items[].hash	string	Hash analizado (solo para hashes)
result.items[].direction	string	Dirección de la transacción cuando aplica
result.items[].network	string	Código de red blockchain
result.items[].status	string	Estado actual (pending, processing, completed, failed)
result.items[].risk_score	float	Puntaje de riesgo
result.items[].risk_level	string	Nivel de riesgo textual (low, medium, high)
result.items[].blacklist	boolean	Indica si hay coincidencia con listas negras
result.items[].risk_factors	array	Conjunto de factores de riesgo
result.items[].checked_at	string	Marca temporal de creación de la verificación (ISO 8601)

Ejemplo de respuesta

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

Posibles errores

Código de error	Descripción
1	Error de autenticación (token o firma incorrectos)
2	Parámetros de paginación o estado inválidos
500	Error interno del servidor