Roqueman API Client
Roqueman est le client d'API de RoqueOS — un Postman/Insomnia qui tourne dans votre bureau web. Construisez et envoyez des requêtes HTTP, WebSocket et GraphQL, organisez le tout en collections, utilisez des variables et environnements, écrivez des scripts de test, et automatisez des flux avec le chaînage de réponses et l'exécuteur de collection — sans rien installer.
Pourquoi c'est utile
Vous testez vos API au même endroit où vous travaillez déjà, avec les données synchronisées sur votre compte. Pas d'application séparée, pas de connexion supplémentaire — ouvrez Roqueman depuis le Launchpad et c'est parti.
Admins : collection serveur automatique
Les administrateurs connectés à un serveur reçoivent automatiquement la collection RoqueOS Server (tous les endpoints de l’API du serveur), avec un environnement pointant vers le serveur actif — prête à l’emploi.
Modes d'exécution
Chaque requête s'exécute dans l'un des trois modes (le sélecteur à côté de l'URL), pour contourner le CORS selon le cas :
- Navigateur (Axios) — envoie directement depuis le navigateur. Idéal pour les API publiques avec CORS activé. C'est le mode requis pour l'envoi de fichiers (le navigateur construit le
multipart/boundary). - Serveur (Proxy) — relaie via votre RoqueOS Server (nécessite le Server Mode connecté). Résout le CORS côté serveur.
- Fonction (Proxy) — relaie via une Cloud Function de RoqueOS (par défaut). Résout le CORS sans serveur propre.
Chaque requête a un délai d'expiration (30s par défaut) : un endpoint lent ne bloque plus l'app — vous recevez un avis d'expiration, distinct d'une annulation manuelle.
Construire une requête
- Méthode + URL : GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS.
- Params : tableau clé/valeur de la query string, avec un interrupteur par ligne.
- Headers : tableau clé/valeur.
- Body :
- JSON / XML / Text — éditeur avec coloration syntaxique.
- Form (urlencoded) — tableau clé/valeur.
- Multipart (form-data) — chaque ligne bascule entre texte et fichier (avec un sélecteur de fichier). L'envoi réel de fichiers nécessite le mode Navigateur.
- Binary — envoie un fichier brut avec son propre content-type.
- Auth : Aucune, Bearer, Basic, API Key (header/query), OAuth 2.0 et Digest.
- Scripts : pré-requête et post-réponse (API
pmcompatible Postman —pm.environment.set,pm.test,pm.expect, etc.).
OAuth 2.0 — obtenir un jeton automatiquement
Dans Auth → OAuth 2.0 → Paramètres avancés, renseignez la Token URL, le Client ID/Secret et le Scope, puis cliquez sur Obtenir le jeton. Roqueman récupère le jeton via client credentials (selon le mode d'exécution de l'onglet, donc le proxy gère le CORS) et remplit l'Access Token automatiquement.
Variables et environnements
Utilisez dans n'importe quel champ (URL, headers, params, body, auth). L'ordre de résolution est : globales → variables de la collection → environnement actif → runtime (scripts). Il existe aussi des variables dynamiques comme , , , etc.
Avant l'envoi, Roqueman vous avertit (sans bloquer) si une est introuvable — ainsi une ne part pas silencieusement comme chaîne vide.
Gérez les environnements depuis le sélecteur en haut (engrenage) — créer, éditer, dupliquer, importer/exporter et changer l'environnement actif.
Chaînage réponse → variable
Dans l'onglet Extraire, définissez des règles pour enregistrer des valeurs de la réponse dans des variables pour la requête suivante — sans écrire de script :
- Depuis : Body (chemin JSON, p. ex.
data.token), Header (nom) ou Status. - Variable cible + Portée (Environment ou Global).
Après chaque réponse réussie, la valeur est extraite et enregistrée (notification « Variables enregistrées »). C'est ce qui permet, par exemple, de se connecter et d'utiliser automatiquement le jeton renvoyé dans les requêtes suivantes.
Collections et l'exécuteur
Organisez les requêtes en collections avec des dossiers imbriqués. Enregistrez, dupliquez, déplacez et importez/exportez (format Postman v2.1, cURL et RoqueOS).
Dans le menu contextuel de la collection, Exécuter la collection ouvre l'exécuteur : il lance toutes les requêtes en séquence (racine et dossiers), exécute les scripts de test et affiche le résultat en direct par requête (statut, temps, tests ✓/✕) plus un récapitulatif réussites/échecs. Le chaînage réponse→variable fonctionne dans l'exécuteur, donc les flux avec dépendances entre requêtes se déroulent de bout en bout.
Réponse
Le visualiseur affiche statut, temps et taille, avec les onglets Body (avec coloration et mode brut), Headers, Cookies et Tests (résultats des scripts post-réponse). Vous pouvez copier, télécharger et générer du code pour la requête dans 9 langages (cURL, Fetch, Axios, Python, PHP, Go, Java, C#, Ruby).
WebSocket et GraphQL
Utilisez le bouton + (à côté des onglets) pour créer un onglet WebSocket ou GraphQL :
- WebSocket : connectez-vous, envoyez du texte/JSON et observez le journal des messages. Avec Reconnexion automatique activée (par défaut), une coupure inattendue déclenche une reconnexion avec backoff exponentiel — une déconnexion manuelle ne se reconnecte pas.
- GraphQL : éditeur de query + variables + introspection du schéma.
Onglets et historique
- Onglets multi-requêtes avec un état « non enregistré » ; les onglets ouverts et le brouillon survivent à un rechargement (aucun travail perdu).
- Historique des requêtes envoyées, groupé par date, avec recherche et relecture.
FAQ
L'envoi de fichiers ne marche pas. Passez le mode d'exécution en Navigateur (Axios) — lui seul construit un vrai multipart/form-data. Le proxy serveur/fonction ne relaie pas les envois de fichiers.
Où sont stockées mes données ? Collections, requêtes, environnements, globales et historique vivent dans votre compte (Firebase), synchronisés entre appareils. Les onglets ouverts restent dans le navigateur local.
Les variables d'environnement sont-elles secrètes ? Elles sont stockées en texte dans votre compte. Ne mettez pas de secrets de production sensibles dans des environnements partagés.
Il affiche « délai expiré ». La requête a dépassé 30s. Vérifiez l'endpoint, le réseau ou le mode d'exécution.