Roqueman API Client
Roqueman ist der API-Client von RoqueOS — ein Postman/Insomnia, das in deinem Web-Desktop läuft. Erstelle und sende HTTP-, WebSocket- und GraphQL-Anfragen, organisiere alles in Sammlungen, nutze Variablen und Umgebungen, schreibe Test-Skripte und automatisiere Abläufe mit Antwort-Verkettung und dem Sammlungs-Runner — ganz ohne Installation.
Warum das nützlich ist
Du testest deine APIs am selben Ort, an dem du ohnehin arbeitest, mit Daten, die mit deinem Konto synchronisiert sind. Keine separate App, kein zusätzlicher Login — öffne Roqueman über das Launchpad und los geht's.
Admins: automatische Server-Sammlung
Admins mit verbundenem Server erhalten automatisch die Sammlung RoqueOS Server (alle Server-API-Endpunkte) plus eine passende Umgebung, die auf den aktiven Server zeigt — sofort ausführbar.
Ausführungsmodi
Jede Anfrage läuft in einem von drei Modi (der Auswahl neben der URL), um CORS je nach Szenario zu umgehen:
- Browser (Axios) — sendet direkt aus dem Browser. Ideal für öffentliche APIs mit aktiviertem CORS. Dies ist der für den Datei-Upload nötige Modus (der Browser erzeugt die
multipart/boundary). - Server (Proxy) — leitet über deinen RoqueOS Server weiter (erfordert verbundenen Server Mode). Löst CORS serverseitig.
- Funktion (Proxy) — leitet über eine RoqueOS Cloud Function weiter (Standard). Löst CORS ohne eigenen Server.
Jede Anfrage hat ein Zeitlimit (standardmäßig 30s): ein langsamer Endpunkt friert die App nicht mehr ein — du bekommst einen Timeout-Hinweis, unterscheidbar von einem manuellen Abbruch.
Eine Anfrage bauen
- Methode + URL: GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS.
- Params: Schlüssel/Wert-Tabelle der Query-String, mit Schalter pro Zeile.
- Headers: Schlüssel/Wert-Tabelle.
- Body:
- JSON / XML / Text — Editor mit Syntaxhervorhebung.
- Form (urlencoded) — Schlüssel/Wert-Tabelle.
- Multipart (form-data) — jede Zeile wechselt zwischen Text und Datei (mit Dateiauswahl). Echter Datei-Upload erfordert den Browser-Modus.
- Binary — sendet eine rohe Datei mit ihrem eigenen Content-Type.
- Auth: Keine, Bearer, Basic, API Key (Header/Query), OAuth 2.0 und Digest.
- Skripte: Pre-Request und Post-Response (Postman-kompatible
pm-API —pm.environment.set,pm.test,pm.expect, usw.).
OAuth 2.0 — Token automatisch holen
Unter Auth → OAuth 2.0 → Erweiterte Einstellungen trägst du Token-URL, Client ID/Secret und Scope ein und klickst Token holen. Roqueman holt das Token per Client Credentials (über den Ausführungsmodus des Tabs, sodass der Proxy CORS löst) und füllt den Access Token automatisch ein.
Variablen und Umgebungen
Verwende in jedem Feld (URL, Headers, Params, Body, Auth). Die Auflösungsreihenfolge ist: Globale → Sammlungs-Variablen → aktive Umgebung → Runtime (Skripte). Es gibt auch dynamische Variablen wie , , , usw.
Vor dem Senden warnt dich Roqueman (nicht blockierend), wenn eine nicht gefunden wurde — so geht ein nicht stillschweigend als leerer String raus.
Verwalte Umgebungen über die Auswahl oben (Zahnrad) — erstellen, bearbeiten, duplizieren, importieren/exportieren und die aktive Umgebung wechseln.
Antwort → Variable-Verkettung
Im Tab Extrahieren definierst du Regeln, um Antwortwerte für die nächste Anfrage in Variablen zu speichern — ohne ein Skript zu schreiben:
- Von: Body (JSON-Pfad, z. B.
data.token), Header (Name) oder Status. - Ziel-Variable + Bereich (Environment oder Global).
Nach jeder erfolgreichen Antwort wird der Wert extrahiert und gespeichert (Hinweis „Variablen gespeichert"). So kannst du dich z. B. anmelden und das zurückgegebene Token automatisch in den folgenden Anfragen verwenden.
Sammlungen und der Runner
Organisiere Anfragen in Sammlungen mit verschachtelten Ordnern. Speichern, duplizieren, verschieben und importieren/exportieren (Postman-v2.1-Format, cURL und RoqueOS).
Im Kontextmenü der Sammlung öffnet Sammlung ausführen den Runner: er führt alle Anfragen nacheinander aus (Wurzel und Ordner), läuft die Test-Skripte und zeigt das Ergebnis live pro Anfrage (Status, Zeit, Tests ✓/✕) plus eine Zusammenfassung bestanden/fehlgeschlagen. Die Antwort→Variable-Verkettung funktioniert im Runner, sodass Abläufe mit Abhängigkeiten zwischen Anfragen durchgängig laufen.
Antwort
Der Viewer zeigt Status, Zeit und Größe, mit Tabs für Body (mit Hervorhebung und Roh-Modus), Headers, Cookies und Tests (Ergebnisse der Post-Response-Skripte). Du kannst die Anfrage kopieren, herunterladen und Code generieren in 9 Sprachen (cURL, Fetch, Axios, Python, PHP, Go, Java, C#, Ruby).
WebSocket und GraphQL
Über die Schaltfläche + (neben den Tabs) erstellst du einen WebSocket- oder GraphQL-Tab:
- WebSocket: verbinden, Text/JSON senden und das Nachrichtenprotokoll beobachten. Mit Automatisch neu verbinden (Standard) löst ein unerwarteter Abbruch eine erneute Verbindung mit exponentiellem Backoff aus — ein manuelles Trennen verbindet nicht neu.
- GraphQL: Query-Editor + Variablen + Schema-Introspektion.
Tabs und Verlauf
- Tabs für mehrere Anfragen mit „ungespeichert"-Status; offene Tabs und der Entwurf überstehen ein Neuladen (keine verlorene Arbeit).
- Verlauf gesendeter Anfragen, nach Datum gruppiert, mit Suche und Wiederholung.
FAQ
Datei-Upload funktioniert nicht. Stelle den Ausführungsmodus auf Browser (Axios) — nur er erzeugt echtes multipart/form-data. Der Server-/Funktions-Proxy leitet Datei-Uploads nicht weiter.
Wo werden meine Daten gespeichert? Sammlungen, Anfragen, Umgebungen, Globale und Verlauf liegen in deinem Konto (Firebase), geräteübergreifend synchronisiert. Offene Tabs bleiben im lokalen Browser.
Sind Umgebungsvariablen geheim? Sie werden als Text in deinem Konto gespeichert. Lege keine sensiblen Produktionsgeheimnisse in geteilten Umgebungen ab.
Es sagte „Zeitlimit überschritten". Die Anfrage hat 30s überschritten. Prüfe den Endpunkt, das Netzwerk oder den Ausführungsmodus.