ResQ Docs — Tactical OS for Autonomous Disaster Response

ResQ expone dos APIs HTTPS:

API	URL base	Stack
API de infraestructura	`https://api.resq.software`	Rust + Axum
API de coordinación	`https://coordination.resq.software`	TypeScript + Elysia

Si tienes un despliegue autogestionado, sustituye las URLs base por las tuyas. Las formas de las solicitudes son idénticas.

Pasos

Confirma que el servicio está activo

Llama a /health en la API de infraestructura. No requiere autenticación.

curl https://api.resq.software/health

const res = await fetch("https://api.resq.software/health");
console.log(await res.json());

import httpx
print(httpx.get("https://api.resq.software/health").json())

Una respuesta saludable:

{
  "status": "ok",
  "pinata": true,
  "gemini": true,
  "spoon_os": "0.1.0"
}

Obtén un JWT

La API de infraestructura usa JWT bearer. Intercambia credenciales por un token en POST /login.

curl -X POST https://api.resq.software/login \
  -H "Content-Type: application/json" \
  -d '{"username":"TU_USUARIO","password":"TU_CONTRASEÑA"}'

const res = await fetch("https://api.resq.software/login", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ username, password }),
});
const { token, expires_at } = await res.json();

La respuesta contiene un token y una expiración en tiempo Unix:

{
  "token": "eyJhbGciOi...",
  "expires_at": 1746345600
}

Guarda el token de forma segura. Consulta Autenticación para la rotación y el refresco.

Llama a un endpoint autenticado

Envía el token como cabecera Bearer.

curl https://api.resq.software/evidence \
  -H "Authorization: Bearer $RESQ_TOKEN"

const res = await fetch("https://api.resq.software/evidence", {
  headers: { Authorization: `Bearer ${token}` },
});

Recibe telemetría desde la API de coordinación

La API de coordinación expone métricas Prometheus y eventos en streaming (Server-Sent Events) para el estado de la flota en tiempo real.

curl -N https://coordination.resq.software/events

Cada línea es un evento JSON: tramas de telemetría, cambios de estado de misión y aprobaciones HITL.

Elige un SDK

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

TypeScript

@resq-systems/http, @resq-systems/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.

Autenticación

Ciclo de vida del JWT y rotación.

Errores

Envolvente de error y códigos de estado.

Referencia de API

Todos los endpoints, solicitudes y respuestas.

Empieza aquí

Inicio rápido

Pasos

TypeScript

Python

Rust

.NET

Siguiente

Autenticación

Errores

Referencia de API

​Pasos

TypeScript

Python

Rust

.NET

​Siguiente

Autenticación

Errores

Referencia de API

Pasos

Siguiente