API de Verificación

Integra el poder de la verificación descentralizada en tu aplicación. Nuestra API REST te permite verificar textos, URLs e imágenes en segundos.

API REST

Mejora continua

Alta disponibilidad

Inicio Rápido

1. Obtén tu API Key

Regístrate en la waitlist para obtener acceso anticipado a la API y tu clave de autenticación.

2. Haz tu primera llamada

Usa el endpoint /v1/evaluate para enviar contenido a verificar.

3. Procesa la respuesta

Recibe el veredicto, score y señales detalladas para tomar decisiones.

curl -X POST https://api.trustfy.io/v1/evaluate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "modality": "text",
    "services": "auto",
    "policy_profile_id": "policy_marketplace_v1",
    "payload": "Este producto es increíble, 100% original",
    "context": {
      "review_id": "R-987",
      "user_id": "U-321"
    }
  }'

Autenticación

Todas las peticiones a la API deben incluir tu API Key en el header de autorización:

Authorization: Bearer YOUR_API_KEY

Importante

Nunca compartas tu API Key públicamente ni la incluyas en código del lado del cliente.

Endpoints

POST/v1/evaluate

Envía contenido para verificación. Soporta texto, URLs e imágenes.

Parámetros del Body

Parámetro	Tipo	Requerido	Descripción
`modality`	string	Sí	"text" \| "image" \| "url"
`payload`	string	Sí	Contenido a verificar
`services`	string \| array	No	"auto" \| ["truth", "media", "url"]
`policy_profile_id`	string	No	ID del perfil de política a aplicar
`context`	object	No	Metadatos adicionales (review_id, user_id, etc.)

Respuesta de Ejemplo

{
  "claim_id": "CLM-20260111-001",
  "status": "completed",
  "verdict": "veraz",
  "score": 0.87,
  "interval": [0.82, 0.92],
  "signals": {
    "truth": [
      {
        "name": "factual_claim",
        "category": "truth",
        "score": 0.89,
        "notes": "Afirmación verificable con fuentes"
      }
    ],
    "url": []
  },
  "action": "ALLOW",
  "explanation": "El contenido ha sido verificado como veraz con alta confianza.",
  "created_at": "2026-01-11T10:30:00Z",
  "completed_at": "2026-01-11T10:30:02Z"
}

GET/v1/claims/{id}

Consulta el estado y resultado de una verificación por su ID.

Parámetros de URL

Parámetro	Tipo	Descripción
`id`	string	ID único de la verificación (claim_id)

Estados posibles

queuedprocessingcompletedfailed

Veredictos y Acciones

Veredictos

veraz- Contenido verificado como verdadero

probablemente_falso- Contenido probablemente falso

insuficiente- Evidencia insuficiente

abstención- No se puede determinar

Acciones Recomendadas

ALLOW- Aprobar automáticamente

REVIEW- Requiere revisión manual

QUARANTINE- Cuarentena para análisis

BLOCK- Rechazar automáticamente

Límites de Rate

Plan	Requests/min	Requests/día	Tamaño máx.
Beta (Waitlist)	60	1,000	10 MB
Starter	120	10,000	25 MB
Enterprise	Ilimitado	Ilimitado	100 MB

SDKs Oficiales

🐍

Python

1.0.0-beta

📦

JavaScript/Node.js

1.0.0-beta

🔷

Go

Próximamente

¿Listo para empezar?

Únete a la waitlist para obtener acceso anticipado a la API y ser de los primeros en integrar verificación descentralizada en tu aplicación.

Unirse a la Waitlist