DEV Community

Cover image for Qu'est-ce que Restfox
Antoine Laurent
Antoine Laurent

Posted on • Originally published at apidog.com

Qu'est-ce que Restfox

Restfox est un client HTTP gratuit et open source pour tester des API. Il fonctionne sur desktop, dans le navigateur et hors ligne. Si vous voulez envoyer rapidement des requêtes sans compte, sans synchronisation cloud imposée et avec un outil léger, Restfox est une option à évaluer.

Essayez Apidog dès aujourd’hui

Ce guide vous montre comment utiliser Restfox dans un flux de développement API : installation, organisation des requêtes, variables d’environnement, import depuis Postman/OpenAPI, plugins JavaScript et limites à connaître avant de l’intégrer à votre stack.

Qu'est-ce que Restfox ?

Restfox est un client de test HTTP et Socket, prioritairement hors ligne, disponible pour le web et les postes de travail. L’outil est construit avec Vue, ce qui donne une interface rapide et une base de code accessible. La version la plus récente est la v0.40.0, publiée mi-2025, ce qui indique que le projet est actif et maintenu.

Restfox

Restfox répond à un besoin simple : tester des API sans outil lourd, sans création de compte et sans envoyer vos collections vers un cloud tiers. Il s’inspire de clients comme Insomnia et Postman, mais se concentre sur le cycle essentiel :

  1. Créer une requête.
  2. Ajouter méthode, URL, headers et body.
  3. Organiser les requêtes en collections.
  4. Réutiliser des variables via des environnements.
  5. Lire et comparer les réponses.

Pas de connexion forcée, pas de workflow imposé.

Conçu pour être hors ligne et open source

Restfox repose sur deux principes importants pour les développeurs : offline-first et open source.

En pratique, le mode offline-first signifie que vos collections, environnements et historiques restent locaux. Vous pouvez ouvrir l’application desktop sans connexion internet et continuer à travailler. Vous pouvez aussi utiliser la version navigateur comme PWA, avec des données stockées côté navigateur.

C’est utile si vos requêtes contiennent :

  • des tokens d’authentification ;
  • des noms d’hôtes internes ;
  • des payloads clients ;
  • des endpoints non publics ;
  • des environnements de staging ou préproduction.

Pour une vue plus large de cette catégorie, consultez notre récapitulatif des meilleurs clients API hors ligne.

Restfox est aussi open source sous licence MIT. Vous pouvez lire le code, le forker et l’auto-héberger si nécessaire. Si votre priorité est d’utiliser un client API gratuit, Restfox répond très bien à ce besoin.

Fonctionnalités clés de Restfox

Restfox couvre les tâches quotidiennes d’un développeur API : envoyer des requêtes, organiser des endpoints, gérer des variables et inspecter les réponses.

1. Créer et envoyer des requêtes HTTP

Le générateur de requêtes prend en charge les méthodes HTTP courantes :

  • GET
  • POST
  • PUT
  • PATCH
  • DELETE
  • etc.

Un workflow typique ressemble à ceci :

GET https://api.example.com/users
Authorization: Bearer {{token}}
Accept: application/json
Enter fullscreen mode Exit fullscreen mode

Vous configurez :

  • l’URL ;
  • la méthode ;
  • les headers ;
  • les paramètres ;
  • le body ;
  • l’environnement actif.

Restfox prend en charge HTTP, HTTPS, WebSocket et GraphQL, ce qui couvre la majorité des tests API courants.

2. Organiser les endpoints avec des collections

Les collections servent à structurer vos requêtes par projet, domaine fonctionnel ou service.

Exemple d’organisation :

Mon API
├── Auth
│   ├── Login
│   └── Refresh token
├── Users
│   ├── List users
│   ├── Get user by ID
│   └── Update user
└── Billing
    ├── Create invoice
    └── Get invoice
Enter fullscreen mode Exit fullscreen mode

Cette structure devient vite indispensable dès que vous testez plus que quelques endpoints. Pour aller plus loin sur ce type d’outil, notre guide sur les clients API REST détaille les modèles communs.

3. Gérer les variables avec les environnements

Les environnements évitent de dupliquer les mêmes valeurs dans toutes vos requêtes.

Par exemple :

{
  "baseUrl": "https://api-staging.example.com",
  "token": "eyJhbGciOi...",
  "userId": "123"
}
Enter fullscreen mode Exit fullscreen mode

Vous pouvez ensuite utiliser ces variables dans vos requêtes :

GET {{baseUrl}}/users/{{userId}}
Authorization: Bearer {{token}}
Enter fullscreen mode Exit fullscreen mode

Pour passer de staging à production, vous changez simplement d’environnement au lieu de modifier chaque requête.

4. Consulter l’historique des réponses

Restfox conserve localement les réponses reçues. Vous pouvez revenir sur une réponse précédente sans renvoyer la requête.

C’est pratique pour :

  • comparer deux résultats ;
  • vérifier une régression ;
  • relire un payload d’erreur ;
  • conserver une trace rapide pendant le debug.

5. Utiliser la même logique sur web et desktop

Restfox propose une expérience similaire entre l’application desktop et la PWA navigateur. L’interface et le modèle de données restent cohérents, ce qui réduit le coût de changement entre machines.

Si vous travaillez sur plusieurs OS, consultez aussi nos notes sur l’exécution d’un client API sur Mac et Windows.

Installer Restfox

Restfox propose plusieurs méthodes d’installation. Choisissez celle qui correspond à votre environnement.

macOS

brew install restfox
Enter fullscreen mode Exit fullscreen mode

Linux

sudo snap install restfox
Enter fullscreen mode Exit fullscreen mode

Windows

scoop install restfox
Enter fullscreen mode Exit fullscreen mode

Navigateur

Ouvrez la PWA sur restfox.dev et installez-la comme une application web.

Docker

Restfox peut aussi être exécuté via une image pré-construite. Cette option est utile si vous voulez héberger une instance dans votre propre infrastructure, derrière votre pare-feu.

Ce modèle permet à une équipe de garder le contrôle sur :

  • l’accès réseau ;
  • les données ;
  • les environnements ;
  • l’hébergement ;
  • les politiques internes de sécurité.

Restfox publie également des binaires RPM, DEB et autres pour une installation directe si vous ne voulez pas passer par un gestionnaire de paquets.

Pour mieux comprendre les compromis liés aux clients exécutés dans un navigateur, consultez notre article sur les clients API basés sur le web.

Importer des collections existantes

Vous n’avez pas besoin de repartir de zéro. Restfox peut importer des collections depuis :

  • Postman ;
  • Insomnia ;
  • des spécifications OpenAPI.

C’est utile si vous avez déjà :

  • une collection Postman utilisée par l’équipe ;
  • une spec OpenAPI maintenue dans le dépôt ;
  • des requêtes Insomnia existantes ;
  • un export de projet à migrer vers un outil plus léger.

Le flux est généralement le suivant :

  1. Exporter la collection ou la spécification depuis l’outil source.
  2. Ouvrir Restfox.
  3. Lancer l’import.
  4. Vérifier les variables et environnements.
  5. Tester quelques requêtes critiques.

Ce support d’import réduit le coût d’essai. Vous pouvez tester Restfox sans reconstruire manuellement chaque endpoint. Si vous comparez plusieurs outils, notre liste des alternatives à Postman couvre un champ plus large.

Étendre Restfox avec des plugins JavaScript

Restfox inclut un système de plugins. Les plugins sont écrits en JavaScript et peuvent agir sur les requêtes ou les réponses.

Les capacités documentées incluent notamment :

  • lire et définir des variables d’environnement depuis une réponse ;
  • tester le contenu d’une réponse ;
  • décoder des tokens JWT ;
  • utiliser crypto-js ;
  • gérer la compression GZIP ;
  • envoyer des requêtes HTTP depuis un plugin.

Cas d’usage typique : récupérer un token après une requête de login et l’injecter dans l’environnement.

Pseudo-flux :

1. Envoyer POST /login
2. Lire access_token dans la réponse
3. Stocker access_token dans une variable d’environnement
4. Réutiliser {{access_token}} dans les requêtes suivantes
Enter fullscreen mode Exit fullscreen mode

Autre cas d’usage : signer une requête avec un schéma personnalisé avant l’envoi.

1. Lire le body de la requête
2. Calculer une signature avec crypto-js
3. Ajouter un header X-Signature
4. Envoyer la requête
Enter fullscreen mode Exit fullscreen mode

Ce modèle garde l’application principale légère tout en permettant aux utilisateurs avancés d’automatiser des tâches répétitives.

Restfox n’est pas un framework complet d’automatisation de tests, mais ses plugins couvrent beaucoup de besoins pratiques pendant le développement et le debug.

Limites à connaître avant d’adopter Restfox

Restfox est volontairement ciblé. Il fait bien son travail de client API léger, mais il ne couvre pas tout le cycle de vie API.

Pas d’exécuteur CLI

Restfox est un outil graphique. Il ne fournit pas d’exécuteur en ligne de commande pour lancer vos collections dans un pipeline CI.

Si vous avez besoin d’un workflow comme celui-ci :

api-tests run collection.json --env staging
Enter fullscreen mode Exit fullscreen mode

Restfox seul ne suffit pas.

Pas de serveur de mock intégré

Restfox envoie des requêtes, mais ne crée pas de faux endpoints pour simuler une API avant que le backend soit prêt.

Si votre frontend doit travailler contre une API simulée, vous devrez utiliser un autre outil.

Pas de couche de conception d’API

Restfox importe des spécifications OpenAPI, mais ne fournit pas d’éditeur visuel complet pour concevoir une API à partir de zéro.

Pas de génération de documentation

Restfox ne publie pas de documentation API interactive pour votre équipe ou vos utilisateurs.

Ces limites ne sont pas des défauts. Elles définissent simplement le périmètre de l’outil. Restfox est pertinent si votre besoin principal est d’envoyer, modifier et inspecter des requêtes localement.

Quand un client léger ne suffit plus

Un client de requêtes résout une partie du travail API. Quand un projet grandit, d’autres besoins apparaissent :

  • concevoir le contrat API ;
  • maintenir une spécification OpenAPI ;
  • simuler des endpoints avant le backend ;
  • automatiser les tests ;
  • exécuter les tests en CI ;
  • publier une documentation interactive ;
  • collaborer avec une équipe.

C’est le type de scénario où une plateforme tout-en-un comme Apidog devient plus adaptée.

Apidog couvre le cycle de vie complet des API en un seul endroit :

  • conception visuelle OpenAPI ;
  • scénarios de test automatisés avec assertions visuelles ;
  • mock sans code ;
  • documentation interactive auto-générée ;
  • espaces de travail d’équipe partagés ;
  • synchronisation en temps réel ;
  • application desktop sur Windows, Mac et Linux ;
  • application web ;
  • CLI pour la CI.

Le CLI est particulièrement important si vous voulez exécuter des tests API enregistrés dans un pipeline. Le CLI Apidog lance des scénarios de test avec des rapporteurs pour les sorties CLI, HTML, JSON et JUnit.

À noter : le CLI Apidog exécute des suites enregistrées. Ce n’est pas un outil interactif de requêtes terminal. Pour des requêtes ad hoc en ligne de commande, curl ou HTTPie restent adaptés.

Apidog prend aussi en charge REST, GraphQL, gRPC, WebSocket, SOAP et Socket.IO, soit une couverture de protocoles plus large que la plupart des clients légers.

Si vous comparez les options, nos articles Apidog vs Insomnia et Apidog vs Bruno détaillent les compromis.

Restfox et Apidog ne répondent donc pas exactement au même besoin :

Besoin Restfox Apidog
Envoyer des requêtes HTTP rapidement Oui Oui
Travailler hors ligne Oui Selon le workflow
Utiliser un client léger sans compte Oui Non orienté uniquement client léger
Concevoir une API Non Oui
Générer une documentation API Non Oui
Créer des mocks Non Oui
Exécuter des tests en CI Non Oui, via CLI
Collaborer sur un cycle de vie API complet Limité Oui

FAQ

Restfox est-il gratuit ?

Oui. Restfox est gratuit et open source sous licence MIT. Il n’y a pas de niveau payant et aucune obligation de créer un compte.

Restfox fonctionne-t-il hors ligne ?

Oui. Restfox est offline-first. Vos collections, environnements et historiques de requêtes restent sur votre machine, et l’application fonctionne sans connexion à un serveur fournisseur.

Restfox peut-il importer des collections Postman ?

Oui. Restfox importe des collections depuis Postman et Insomnia, et il lit les spécifications OpenAPI. Vous pouvez migrer des requêtes existantes sans les reconstruire.

Restfox a-t-il un CLI ?

Non. Restfox est un client graphique sans exécuteur en ligne de commande. Si vous devez lancer des tests API enregistrés en CI, vous aurez besoin d’un outil incluant un CLI, comme Apidog.

Quels protocoles Restfox prend-il en charge ?

Restfox prend en charge HTTP, HTTPS, WebSocket et GraphQL.

Comment installer Restfox ?

Utilisez l’une des commandes suivantes selon votre OS :

# macOS
brew install restfox

# Linux
sudo snap install restfox

# Windows
scoop install restfox
Enter fullscreen mode Exit fullscreen mode

Vous pouvez aussi l’exécuter via Docker ou comme PWA depuis restfox.dev.

Conclusion

Restfox est un client HTTP propre, gratuit et open source pour envoyer et inspecter des requêtes API. Il fonctionne hors ligne, s’installe sur plusieurs plateformes, importe des collections existantes et peut être étendu avec des plugins JavaScript.

Choisissez Restfox si vous voulez :

  • tester rapidement des endpoints ;
  • garder vos données locales ;
  • éviter un compte obligatoire ;
  • utiliser un client léger ;
  • importer des collections Postman, Insomnia ou OpenAPI.

Ses limites sont claires : pas de CLI, pas de mock, pas de conception API et pas de génération de documentation. Si votre travail inclut aussi la conception, les tests automatisés, la simulation et la documentation du contrat API complet, une plateforme comme Apidog complète mieux ce workflow.

Top comments (0)