Listar Alertas
curl --request GET \
--url http://api.gu1.ai/intelligence/alerts \
--header 'Authorization: Bearer <token>'import requests
url = "http://api.gu1.ai/intelligence/alerts"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('http://api.gu1.ai/intelligence/alerts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "http://api.gu1.ai/intelligence/alerts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "http://api.gu1.ai/intelligence/alerts"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("http://api.gu1.ai/intelligence/alerts")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("http://api.gu1.ai/intelligence/alerts")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"alerts": [
{}
],
"count": 123
}Referencia API
Listar Alertas
Obtener alertas para entidades u organizaciones con filtrado y paginación — usando la API de alertas de gu1 para flujos de riesgo y compliance.
GET
/
intelligence
/
alerts
Listar Alertas
curl --request GET \
--url http://api.gu1.ai/intelligence/alerts \
--header 'Authorization: Bearer <token>'import requests
url = "http://api.gu1.ai/intelligence/alerts"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('http://api.gu1.ai/intelligence/alerts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "http://api.gu1.ai/intelligence/alerts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "http://api.gu1.ai/intelligence/alerts"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("http://api.gu1.ai/intelligence/alerts")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("http://api.gu1.ai/intelligence/alerts")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"alerts": [
{}
],
"count": 123
}Descripción General
Recupera alertas para entidades específicas o en toda la organización. Las alertas se generan automáticamente por las reglas cuando se cumplen las condiciones.Endpoint
GET http://api.gu1.ai/intelligence/alerts
Autenticación
Requiere una clave API válida en el encabezado de Autorización:Authorization: Bearer YOUR_API_KEY
Parámetros de Consulta
string
required
ID de entidad para filtrar alertas (persona, empresa o transacción)
string
Filtrar por estado:
PENDING, ACKNOWLEDGED, RESOLVEDstring
Filtrar por severidad:
LOW, MEDIUM, HIGH, CRITICALstring
Filtrar por categoría de alerta
Respuesta
boolean
Si la solicitud fue exitosa
array
Array de objetos de alerta
number
Número total de alertas que coinciden con los filtros
Ejemplos de Solicitudes
Obtener Alertas para Entidad
curl -X GET "http://api.gu1.ai/intelligence/alerts?entityId=550e8400-e29b-41d4-a716-446655440000" \
-H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch(
'http://api.gu1.ai/intelligence/alerts?entityId=550e8400-e29b-41d4-a716-446655440000',
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const data = await response.json();
console.log(`Se encontraron ${data.count} alertas`);
import requests
response = requests.get(
'http://api.gu1.ai/intelligence/alerts',
headers={
'Authorization': 'Bearer YOUR_API_KEY'
},
params={
'entityId': '550e8400-e29b-41d4-a716-446655440000'
}
)
data = response.json()
print(f"Se encontraron {data['count']} alertas")
Filtrar por Severidad y Estado
curl -X GET "http://api.gu1.ai/intelligence/alerts?entityId=550e8400-e29b-41d4-a716-446655440000&severity=CRITICAL&status=PENDING" \
-H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch(
'http://api.gu1.ai/intelligence/alerts?' + new URLSearchParams({
entityId: '550e8400-e29b-41d4-a716-446655440000',
severity: 'CRITICAL',
status: 'PENDING'
}),
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const data = await response.json();
console.log(`Alertas críticas pendientes: ${data.count}`);
response = requests.get(
'http://api.gu1.ai/intelligence/alerts',
headers={
'Authorization': 'Bearer YOUR_API_KEY'
},
params={
'entityId': '550e8400-e29b-41d4-a716-446655440000',
'severity': 'CRITICAL',
'status': 'PENDING'
}
)
data = response.json()
print(f"Alertas críticas pendientes: {data['count']}")
Ejemplo de Respuesta
{
"success": true,
"alerts": [
{
"id": "alert-uuid-123",
"name": "Patrón de Transacción de Alto Riesgo",
"category": "transaction_monitoring",
"severity": "CRITICAL",
"status": "PENDING",
"createdAt": "2024-12-23T10:00:00.000Z",
"updatedAt": "2024-12-23T10:00:00.000Z",
"riskContribution": 25,
"miniAnalysis": "Múltiples transacciones de alto valor detectadas en un corto período de tiempo",
"investigationId": null,
"targetEntityId": "550e8400-e29b-41d4-a716-446655440000",
"triggerCondition": {
"ruleName": "Detección de Transacciones Rápidas",
"threshold": 5,
"actual": 8
},
"sourceSystem": "rules_engine"
}
],
"count": 1
}
Niveles de Severidad de Alertas
- LOW: Informativo, requiere revisión
- MEDIUM: Riesgo moderado, debe ser investigado
- HIGH: Riesgo significativo, requiere atención inmediata
- CRITICAL: Riesgo severo, acción urgente requerida
Flujo de Estado de Alertas
- PENDING: Alerta recién creada, esperando revisión
- ACKNOWLEDGED: La alerta ha sido revisada por el equipo de cumplimiento
- RESOLVED: La alerta ha sido abordada y cerrada
Ver También
Was this page helpful?