Roqueman API Client
Roqueman es el cliente de API de RoqueOS — un Postman/Insomnia que se ejecuta dentro de tu escritorio web. Crea y lanza solicitudes HTTP, WebSocket y GraphQL, organiza todo en colecciones, usa variables y entornos, escribe scripts de prueba y automatiza flujos con encadenamiento de respuestas y el ejecutor de colecciones — sin instalar nada.
Por qué es útil
Pruebas tus APIs en el mismo lugar donde ya trabajas, con los datos sincronizados en tu cuenta. Sin app aparte, sin inicio de sesión extra — abre Roqueman desde el Launchpad y listo.
Admins: colección del servidor automática
Los administradores conectados a un servidor reciben la colección RoqueOS Server (todos los endpoints de la API del servidor) cargada automáticamente, junto con un entorno que apunta al servidor activo — lista para ejecutar.
Modos de ejecución
Cada solicitud se ejecuta en uno de tres modos (el selector junto a la URL), para sortear CORS según el caso:
- Navegador (Axios) — lanza directamente desde el navegador. Ideal para APIs públicas con CORS habilitado. Es el modo necesario para subir archivos (el navegador construye el
multipart/boundary). - Servidor (Proxy) — reenvía a través de tu RoqueOS Server (requiere Server Mode conectado). Resuelve CORS en el servidor.
- Función (Proxy) — reenvía a través de una Cloud Function de RoqueOS (predeterminado). Resuelve CORS sin necesitar servidor propio.
Cada solicitud tiene tiempo límite (30s por defecto): un endpoint lento ya no congela la app — recibes un aviso de tiempo agotado, distinto de una cancelación manual.
Crear una solicitud
- Método + URL: GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS.
- Params: tabla clave/valor de la query string, con interruptor por fila.
- Headers: tabla clave/valor.
- Body:
- JSON / XML / Text — editor con resaltado de sintaxis.
- Form (urlencoded) — tabla clave/valor.
- Multipart (form-data) — cada fila alterna entre texto y archivo (con selector de archivo). La subida real de archivos requiere el modo Navegador.
- Binary — envía un archivo en crudo con su propio content-type.
- Auth: Ninguna, Bearer, Basic, API Key (header/query), OAuth 2.0 y Digest.
- Scripts: pre-solicitud y post-respuesta (API
pmcompatible con Postman —pm.environment.set,pm.test,pm.expect, etc.).
OAuth 2.0 — obtener token automáticamente
En Auth → OAuth 2.0 → Configuración avanzada, rellena la Token URL, Client ID/Secret y Scope y pulsa Obtener token. Roqueman obtiene el token mediante client credentials (por el modo de ejecución de la pestaña, así el proxy resuelve el CORS) y rellena el Access Token automáticamente.
Variables y entornos
Usa en cualquier campo (URL, headers, params, body, auth). El orden de resolución es: globales → variables de la colección → entorno activo → runtime (scripts). También hay variables dinámicas como , , , etc.
Antes de enviar, Roqueman te avisa (sin bloquear) si alguna no se encontró — así un no sale silenciosamente como cadena vacía.
Gestiona los entornos desde el selector superior (engranaje) — crear, editar, duplicar, importar/exportar y cambiar el entorno activo.
Encadenamiento respuesta → variable
En la pestaña Extraer, define reglas para guardar valores de la respuesta en variables para la siguiente solicitud — sin escribir un script:
- De: Body (ruta JSON, p. ej.
data.token), Header (nombre) o Status. - Variable de destino + Ámbito (Environment o Global).
Tras cada respuesta correcta, el valor se extrae y se guarda (aviso "Variables guardadas"). Esto permite, por ejemplo, iniciar sesión y usar automáticamente el token devuelto en las solicitudes siguientes.
Colecciones y el ejecutor
Organiza solicitudes en colecciones con carpetas anidadas. Guarda, duplica, mueve e importa/exporta (formato Postman v2.1, cURL y RoqueOS).
En el menú contextual de la colección, Ejecutar colección abre el ejecutor: corre todas las solicitudes en secuencia (raíz y carpetas), ejecuta los scripts de prueba y muestra el resultado en vivo por solicitud (estado, tiempo, pruebas ✓/✕) más un resumen de aprobadas/fallidas. El encadenamiento respuesta→variable funciona dentro del ejecutor, por lo que los flujos con dependencias entre solicitudes corren de principio a fin.
Respuesta
El visor muestra estado, tiempo y tamaño, con pestañas de Body (con resaltado y modo bruto), Headers, Cookies y Tests (resultados de los scripts post-respuesta). Puedes copiar, descargar y generar código de la solicitud en 9 lenguajes (cURL, Fetch, Axios, Python, PHP, Go, Java, C#, Ruby).
WebSocket y GraphQL
Usa el botón + (junto a las pestañas) para crear una pestaña WebSocket o GraphQL:
- WebSocket: conecta, envía texto/JSON y observa el registro de mensajes. Con Reconexión automática activada (por defecto), una caída inesperada dispara la reconexión con backoff exponencial — una desconexión manual no reconecta.
- GraphQL: editor de query + variables + introspección del esquema.
Pestañas e historial
- Pestañas multi-solicitud con estado "sin guardar"; las pestañas abiertas y el borrador sobreviven a la recarga (no se pierde el trabajo al recargar).
- Historial de solicitudes enviadas, agrupado por fecha, con búsqueda y repetición.
Preguntas frecuentes
La subida de archivos no funciona. Cambia el modo de ejecución a Navegador (Axios) — solo él construye multipart/form-data real. El proxy de servidor/función no reenvía subidas de archivos.
¿Dónde se guardan mis datos? Colecciones, solicitudes, entornos, globales e historial viven en tu cuenta (Firebase), sincronizados entre dispositivos. Las pestañas abiertas quedan en el navegador local.
¿Las variables de entorno son secretas? Se almacenan como texto en tu cuenta. No pongas secretos de producción sensibles en entornos compartidos.
Dijo "tiempo agotado". La solicitud superó los 30s. Revisa el endpoint, la red o el modo de ejecución.