Saltar al contenido principal
ResQ expone dos APIs HTTPS:
APIURL baseStack
API de infraestructurahttps://api.resq.softwareRust + Axum
API de coordinaciónhttps://coordination.resq.softwareTypeScript + Elysia
Si tienes un despliegue autogestionado, sustituye las URLs base por las tuyas. Las formas de las solicitudes son idénticas.

​
Pasos

1

Confirma que el servicio está activo

Llama a /health en la API de infraestructura. No requiere autenticación.
curl https://api.resq.software/health
Una respuesta saludable:
{
  "status": "ok",
  "pinata": true,
  "gemini": true,
  "spoon_os": "0.1.0"
}
2

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"}'
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.
3

Llama a un endpoint autenticado

Envía el token como cabecera Bearer.
curl https://api.resq.software/evidence \
  -H "Authorization: Bearer $RESQ_TOKEN"
4

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.
5

Elige un SDK

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.

​
Siguiente

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.