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.
En la versión actual todos los endpoints documentados se consumen mediante HTTP POST y requieren Bearer Token en el header Authorization.
Convenciones generales
| Tema | Detalle |
|---|---|
| Base URL | https://free.as2expert.com/api/v1 |
| Método | POST para lectura y escritura en esta versión |
| Autenticación | Authorization: Bearer <token> |
| Content-Type | application/json |
| Respuesta OK | {"status":"success","data":...} o {"status":"success","total":n,"data":[...]} |
| Respuesta error | {"status":"error","msg":"..."} |
| Ruta | Scopes | Descripción |
|---|---|---|
| /stations | read | Lista estaciones visibles en el dominio actual |
| /stations/detail | read | Devuelve el detalle ampliado de una estación |
| /stations/stats | read | Operational totals and success rate for a station or folder context |
| /stations/create | write / admin | Crea una estación reutilizando la lógica KMR interna |
| /partners | read | Lista socios, opcionalmente filtrados por estación |
| /partners/detail | read | Devuelve el detalle ampliado de un socio |
| /partners/create | write / admin | Crea un socio comercial |
| /certificates | read | Lista certificados del entorno actual |
| /certificates/detail | read | Devuelve metadatos completos del certificado |
| /certificates/create | write / admin | Genera certificados self-signed |
| /messages | read | Lista mensajes recientes |
| /messages/detail | read | Devuelve detalle básico de un mensaje |
| /messages/download | read | Devuelve el contenido binario del mensaje en base64 |
| /messages/send | write / admin | Envía uno o varios documentos AS2 |
| /webhooks/configure | write | Configura webhooks por socio |
| /webhooks/get | read | Obtiene la configuración de webhook de un socio |
| /webhooks/test | write | Lanza un webhook de prueba |
| /webhooks/logs | read | Lista logs de entregas webhook |
| /dashboard/kpis | read | Resumen rápido de actividad y tasa de éxito de los últimos 30 días |
The examples below use the public Free environment that is currently published and validated: https://free.as2expert.com/api/v1.
curl
curl -X POST "https://free.as2expert.com/api/v1/stations" -H "Authorization: Bearer $API_TOKEN" -H "Content-Type: application/json" -d '{}'
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
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);
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.
| Canonical | Legacy alias | Notes |
|---|---|---|
/stations | /estaciones | Both published in Free |
/messages/detail | /mensajes/detalle | Both require numeric id |
/webhooks/get | /webhooks/obtener | Both published in Free |
| Scope | Uso |
|---|---|
| read | Consultas, listados, detalle, métricas y lectura de logs |
| write | Creación de entidades, envío de mensajes y configuración de webhooks |
| admin | Permite operaciones de escritura en los endpoints que admiten write/admin |
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.
| Superficie | Propósito |
|---|---|
Socios / Trust Lifecycle | Preparar certificados next, programar rollover, activarlo, retirarlo y leer el timeline de eventos. |
Certificados / Usage / Lifecycle | Ver dónde un certificado es current, dónde es next y qué socios quedan afectados. |
TsaProfiles | Configurar endpoints TSA, trust material y lanzar validación RFC3161 real. |
ComplianceRunStart | Ejecutar canaries de release y persistir evidencia pass/warn/fail para el release tag elegido. |
ComplianceReleaseExport | Agrupar 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.