Saltar al contenido principal

API de infraestructura

Estado persistente. Incidentes, evidencia (IPFS), anclaje en blockchain, análisis con IA y operaciones de Solana para espacio aéreo y entregas.

API de coordinación

Operaciones de flota en tiempo real. Lotes de telemetría, alertas predictivas, subidas a IPFS, inyección de fallos, aprobación HITL y streams SSE.

​
URLs base

APIURL base
Infraestructurahttps://api.resq.software
Coordinaciónhttps://coordination.resq.software
Los despliegues autogestionados sustituyen los hostnames por los suyos; las formas de solicitud y respuesta son idénticas.

​
Autenticación

Ambas APIs usan JWT bearer. 
# 1. Intercambia credenciales por un token
curl -X POST https://api.resq.software/login \
  -H "Content-Type: application/json" \
  -d '{"username":"OPERADOR","password":"REDACTED"}'

# 2. Envía el token en cada solicitud protegida
curl https://api.resq.software/evidence \
  -H "Authorization: Bearer $RESQ_TOKEN"
Consulta Autenticación para el ciclo de vida del token, los scopes y la rotación.

​
Convenciones

​
Tipo de contenido

Todas las solicitudes y respuestas usan application/json salvo que un endpoint documente explícitamente otro tipo (por ejemplo, subidas multipart en POST /storage).

​
Tiempo

Las marcas de tiempo en cargas de recursos son cadenas ISO-8601 UTC (2026-05-04T06:01:27Z). La excepción es la expiración del token en /login, que es un timestamp Unix en segundos para facilitar la aritmética.

​
Identificadores

Los IDs de recurso son cadenas opacas. No los parsees; trátalos como identificadores. La evidencia en IPFS se referencia por su CID (identificador direccionado por contenido), que es estable por contenido.

​
Paginación

Los endpoints de listado aceptan los parámetros de query limit (50 por defecto, 200 máximo) y cursor. La respuesta incluye next_cursor cuando hay más páginas disponibles. 
GET /evidence?limit=50&cursor=eyJpZCI6Ii4uLiJ9

​
Idempotencia

Los endpoints mutantes aceptan una cabecera Idempotency-Key. ResQ cachea la respuesta durante 24 horas, por lo que los reintentos devuelven el resultado original en lugar de duplicar el efecto.

​
Request IDs

Cada respuesta lleva una cabecera X-Request-Id. Inclúyela en cualquier reporte de soporte o incidente para correlacionar logs.

​
Errores

Los fallos usan códigos de estado HTTP estándar con una pequeña envolvente JSON. Consulta Errores para la tabla completa de códigos, la guía de reintento y un esbozo de backoff.

​
API de infraestructura

Construida con Rust y Axum. Estado persistente, interacciones con blockchain y análisis asistido por IA. URL base: https://api.resq.software.
TagDescripción
incidentsCrear, listar y recuperar incidentes
evidenceGestionar evidencia capturada por drones (anclada en IPFS)
blockchainRegistrar eventos en cadena; verificar localizaciones
solanaRegistro de espacio aéreo, eventos de entrega y permisos
authAutenticación basada en JWT

​
API de coordinación

Construida con TypeScript y Elysia. Operaciones de flota en tiempo real; diseñada para seguir operando cuando la infraestructura upstream está degradada. URL base: https://coordination.resq.software.
TagDescripción
FleetProcesamiento de lotes de telemetría
IntelligenceReporte de incidentes y alertas predictivas
StorageSubidas de archivos a IPFS
SimulationInyección de fallos para pruebas
AdminSalud del servicio, profiling, aprobación de misiones (HITL, Art. 14 de la Ley de IA de la UE)
ObservabilityMétricas Prometheus y streams SSE

​
SDKs

Evita escribir un cliente — instala uno de los SDKs oficiales.

TypeScript

@resq-sw/http, @resq-sw/security, componentes UI.

Python

resq-mcp (servidor FastMCP) y resq-dsa.

Rust

CLI unificada resq más siete herramientas TUI.

.NET

Clientes tipados, contratos Protobuf, harnesses de simulación.