Introducción

La API pública de AS2Expert expone operaciones de consulta y automatización para estaciones, socios, certificados, mensajes, webhooks y métricas operativas.

POST https://free.as2expert.com/api/v1/*

En la versión actual todos los endpoints documentados se consumen mediante HTTP POST y requieren Bearer Token en el header Authorization.

Convenciones generales
TemaDetalle
Base URLhttps://free.as2expert.com/api/v1
MétodoPOST para lectura y escritura en esta versión
AutenticaciónAuthorization: Bearer <token>
Content-Typeapplication/json
Respuesta OK{"status":"success","data":...} o {"status":"success","total":n,"data":[...]}
Respuesta error{"status":"error","msg":"..."}
POST Catálogo de endpoints
RutaScopesDescripción
/stationsreadLista estaciones visibles en el dominio actual
/stations/detailreadDevuelve el detalle ampliado de una estación
/stations/statsreadOperational totals and success rate for a station or folder context
/stations/createwrite / adminCrea una estación reutilizando la lógica KMR interna
/partnersreadLista socios, opcionalmente filtrados por estación
/partners/detailreadDevuelve el detalle ampliado de un socio
/partners/createwrite / adminCrea un socio comercial
/certificatesreadLista certificados del entorno actual
/certificates/detailreadDevuelve metadatos completos del certificado
/certificates/createwrite / adminGenera certificados self-signed
/messagesreadLista mensajes recientes
/messages/detailreadDevuelve detalle básico de un mensaje
/messages/downloadreadDevuelve el contenido binario del mensaje en base64
/messages/sendwrite / adminEnvía uno o varios documentos AS2
/webhooks/configurewriteConfigura webhooks por socio
/webhooks/getreadObtiene la configuración de webhook de un socio
/webhooks/testwriteLanza un webhook de prueba
/webhooks/logsreadLista logs de entregas webhook
/dashboard/kpisreadResumen rápido de actividad y tasa de éxito de los últimos 30 días
POST Working examples

The examples below use the public Free environment that is currently published and validated: https://free.as2expert.com/api/v1.

curl
curl
curl -X POST "https://free.as2expert.com/api/v1/stations"   -H "Authorization: Bearer $API_TOKEN"   -H "Content-Type: application/json"   -d '{}'
Python
Python
import requests

BASE_URL = "https://free.as2expert.com/api/v1"
headers = {
    "Authorization": "Bearer TU_TOKEN",
    "Content-Type": "application/json",
}

response = requests.post(
    f"{BASE_URL}/dashboard/kpis",
    headers=headers,
    json={}
)
print(response.json())
JavaScript
JavaScript
const response = await fetch("https://free.as2expert.com/api/v1/messages", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ limit: 10 })
});

const data = await response.json();
console.log(data);
POST Legacy compatibility

The main documentation uses canonical English routes and payload keys. Legacy Spanish aliases remain accepted for compatibility, but they are intentionally kept secondary to avoid polluting the primary reading flow.

CanonicalLegacy aliasNotes
/stations/estacionesBoth published in Free
/messages/detail/mensajes/detalleBoth require numeric id
/webhooks/get/webhooks/obtenerBoth published in Free
POST Scopes
ScopeUso
readConsultas, listados, detalle, métricas y lectura de logs
writeCreación de entidades, envío de mensajes y configuración de webhooks
adminPermite operaciones de escritura en los endpoints que admiten write/admin
POST Trust y evidencia de release

La API pública se centra en integraciones de negocio. El trust lifecycle, la verificación TSA y los gates de compliance se gobiernan desde la UI de producto y desde backends internos.

SuperficiePropósito
Socios / Trust LifecyclePreparar certificados next, programar rollover, activarlo, retirarlo y leer el timeline de eventos.
Certificados / Usage / LifecycleVer dónde un certificado es current, dónde es next y qué socios quedan afectados.
TsaProfilesConfigurar endpoints TSA, trust material y lanzar validación RFC3161 real.
ComplianceRunStartEjecutar canaries de release y persistir evidencia pass/warn/fail para el release tag elegido.
ComplianceReleaseExportAgrupar un release tag en un único veredicto de gate y exportar un resumen markdown legible.

Esta capa se mantiene intencionadamente fuera de la API pública Free porque es una superficie de gobierno operativo, no un contrato genérico de integración de terceros.