Insomnie et Perte de Données: Récupération et Migration

fTL;DR

Si vous avez mis à niveau vers Insomnia 8.0 et avez perdu l'accès à vos collections, vos données sont probablement toujours sur le disque. Ce guide vous montre comment les trouver, les récupérer de la base de données SQLite et migrer proprement vers Apidog ou une autre alternative. Agissez avant d'installer toute mise à jour supplémentaire qui pourrait écraser vos fichiers de sauvegarde.

💡

Apidog est une plateforme de développement API tout-en-un gratuite. Elle importe directement les collections Insomnia et stocke vos données localement sans nécessiter de compte. Essayez Apidog gratuitement, aucune carte de crédit requise.

bouton

Introduction

La mise à jour Insomnia 8.0, déployée en septembre 2023, a introduit une connexion cloud obligatoire. Pour de nombreux utilisateurs, cette mise à niveau a eu un résultat désorientant : l'application s'ouvrait sur un écran de connexion, et les collections qu'ils avaient construites pendant des mois ou des années semblaient avoir disparu.

Certaines pertes de données étaient réelles – en particulier les cas où le stockage temporaire (scratch storage) a corrompu des données sur certains systèmes. Mais dans de nombreux cas, les fichiers de base de données SQLite sous-jacents étaient toujours intacts sur le disque, juste inaccessibles via la nouvelle interface utilisateur sans un compte Kong.

Ce guide est valable pour les deux situations. Si vos données sont toujours là, vous découvrirez comment les récupérer. Si le stockage temporaire a réellement perdu vos données, vous découvrirez quelles options de récupération existent et comment éviter le même problème à l'avenir en migrant vers un outil avec un modèle local-first plus fiable.

Étape 1 : Localiser vos fichiers de base de données Insomnia existants

Avant de faire quoi que ce soit d'autre – avant de réinstaller, avant de créer un compte Kong, avant d'ouvrir à nouveau Insomnia – localisez vos fichiers de base de données existants et copiez-les à un endroit sûr.

Insomnia stockait les données à différents emplacements selon la version et le système d'exploitation.

macOS :

~/Library/Application Support/Insomnia/

Windows :

C:\Users\[Nom d'utilisateur]\AppData\Roaming\Insomnia\

Linux :

~/.config/Insomnia/

Dans ce répertoire, recherchez ces fichiers :

insomnia.db – la base de données principale (anciennes versions)
Un répertoire appelé core/ contenant des fichiers .db – courant dans les versions antérieures à 8.0
workspaces/ – peut contenir des fichiers JSON exportés d'exportations antérieures

Copiez l'intégralité du répertoire de support de l'application Insomnia vers un emplacement de sauvegarde dès maintenant. Ne sautez pas cette étape. Si vous effectuez d'autres mises à niveau ou désinstallez/réinstallez Insomnia, il y a un risque que ces fichiers soient écrasés ou supprimés.

Étape 2 : Tenter la récupération via l'interface utilisateur d'Insomnia

Si vous ne vous êtes pas encore connecté à un compte Kong, essayez d'abord le chemin de stockage temporaire (scratch storage). Lorsque Insomnia affiche l'écran de connexion, recherchez un lien ou un bouton indiquant quelque chose comme « Utiliser sans compte » ou « Continuer avec le stockage local ». Le libellé exact a changé selon les versions.

Si vous parvenez à accéder à l'application sans vous connecter, exportez immédiatement chaque espace de travail :

Cliquez sur le nom d'un espace de travail dans la barre latérale gauche
Allez dans le menu de l'espace de travail (trois points ou icône d'engrenage)
Choisissez « Exporter »
Sélectionnez le format « Insomnia v4 (JSON) »
Enregistrez le fichier en lieu sûr
Répétez l'opération pour chaque espace de travail

Si vous avez déjà un compte Kong et pouvez vous connecter, effectuez le même processus d'exportation. L'expérience de connexion vous donne accès à vos espaces de travail synchronisés, qui peuvent être plus complets que ce qui se trouve sur le disque si vous aviez synchronisé auparavant.

Étape 3 : Récupérer les données directement depuis la base de données SQLite

Si l'interface utilisateur ne vous donne pas accès à vos données, vous pouvez les extraire directement du fichier de base de données. Cela nécessite un outil de navigation SQLite gratuit.

Installer DB Browser for SQLite. Téléchargez-le depuis sqlitebrowser.org. Il est gratuit, open source et disponible pour macOS, Windows et Linux.

Ouvrez votre fichier de base de données. Dans DB Browser, allez dans Fichier > Ouvrir la base de données et naviguez jusqu'au répertoire de support de l'application Insomnia. Ouvrez insomnia.db ou tout autre fichier .db que vous y trouvez.

Explorez le schéma. La base de données d'Insomnia contient plusieurs tables qui vous intéressent :

Workspace – vos espaces de travail de niveau supérieur
RequestGroup – dossiers au sein des espaces de travail
Request – requêtes individuelles
Environment – ensembles de variables d'environnement
Response – historique des réponses stockées (facultatif à récupérer)

Exportez les données. Dans l'onglet Parcourir les données, sélectionnez chaque table et utilisez Fichier > Exporter > Table en CSV pour enregistrer les données brutes. Pour les requêtes, les champs clés sont name, url, method, headers (stockés en JSON) et body.

Reconstituez les collections. L'approche CSV vous donne les données brutes à partir desquelles reconstruire. C'est fastidieux mais fiable. Pour une approche programmatique, vous pouvez utiliser le module sqlite3 de Python pour interroger la base de données et écrire un script d'exportation.

Voici un script Python minimal pour extraire les requêtes d'une ancienne base de données Insomnia :

import sqlite3
import json

conn = sqlite3.connect('/chemin/vers/insomnia.db')
cursor = conn.cursor()

cursor.execute("SELECT name, url, method, headers, body FROM Request")
rows = cursor.fetchall()

for row in rows:
    print(f"Name: {row[0]}")
    print(f"Method: {row[2]} {row[1]}")
    if row[3]:
        headers = json.loads(row[3])
        for h in headers:
            print(f"  Header: {h.get('name')}: {h.get('value')}")
    print()

conn.close()

Ajustez les noms de champs en fonction de ce que vous voyez dans DB Browser – le schéma exact variait selon les versions d'Insomnia.

Étape 4 : Récupérer à partir de sauvegardes si la base de données est corrompue

Si le fichier de base de données lui-même est corrompu, les options sont plus limitées.

Vérifiez Time Machine ou les sauvegardes système. macOS Time Machine, Historique des fichiers Windows et la plupart des services de sauvegarde cloud (Backblaze, iCloud Drive, etc.) peuvent avoir des instantanés de votre répertoire Insomnia d'avant la mise à niveau. Restaurez la version pré-8.0 du répertoire de support de l'application à un emplacement séparé, puis utilisez DB Browser pour lire ces fichiers.

Vérifiez l'historique Git. Certaines équipes versionnent leurs exportations Insomnia dans un dépôt Git. Si votre organisation le fait, les fichiers d'exportation sont récupérables à partir de l'historique Git.

Recherchez les fichiers d'exportation Insomnia. Si vous avez déjà exporté manuellement des collections par le passé, ces fichiers JSON peuvent se trouver dans votre dossier Téléchargements ou un répertoire de projet. Recherchez sur votre système de fichiers les fichiers se terminant par .json qui contiennent « insomnia » ou « _collection » dans leur nom.

Étape 5 : Migrer vers Apidog

Une fois que vous avez vos données au format JSON Insomnia v4 (soit à partir d'une exportation de l'interface utilisateur, soit reconstruites manuellement), la migration vers Apidog ne prend que quelques minutes.

Importez vos collections.

Ouvrez Apidog et créez un nouveau projet
Allez dans les paramètres du projet ou l'option d'importation dans la barre latérale
Choisissez « Importer » et sélectionnez « Insomnia »
Téléchargez votre fichier JSON exporté
Apidog analysera les espaces de travail, les dossiers, les requêtes et les environnements

Ce qui est transféré proprement :

Requêtes HTTP (GET, POST, PUT, DELETE, PATCH)
En-têtes de requête
Corps de requête (JSON, données de formulaire, multipart)
Paramètres d'URL et variables de chemin
Variables d'environnement et leurs valeurs
Structure des dossiers

Ce qui nécessite une vérification manuelle :

Scripts de pré-requête et de post-requête (JavaScript). Apidog utilise un modèle de script similaire, mais la syntaxe pourrait nécessiter un ajustement.
Flux d'authentification personnalisés qui s'appuyaient sur des plugins Insomnia
Assertions de test de réponse – celles-ci doivent être resaisies au format de test d'Apidog

Configurez vos environnements. Après l'importation, vérifiez que les variables d'environnement ont été importées correctement. Accédez au panneau Environnements et vérifiez les URL de base, les clés API et les jetons transférés.

Vérifiez l'accès de l'équipe. Si vous migrez un espace de travail d'équipe, Apidog prend en charge les espaces de travail partagés avec une synchronisation cloud facultative. Vous contrôlez si les données sont synchronisées avec le cloud d'Apidog. Pour les équipes, activer la synchronisation une fois est le moyen le plus simple de partager les collections migrées.

Testez quelques requêtes. Choisissez cinq ou six requêtes représentatives de votre collection et exécutez-les pour confirmer qu'elles fonctionnent comme prévu. Portez une attention particulière aux en-têtes d'authentification et à la substitution des variables d'environnement.

Comment éviter ce problème à l'avenir

La principale leçon de la situation Insomnia 8.0 est que confier vos données de travail critiques à un seul outil sans stratégie de sauvegarde est risqué – quel que soit l'outil que vous utilisez.

Quelques habitudes qui vous protégeront à l'avenir :

Exportez régulièrement. Planifiez une exportation mensuelle de vos collections vers un dossier de sauvegarde ou un dépôt Git. Cela prend deux minutes et vous offre une voie de récupération quoi qu'il arrive.

Choisissez des outils "local-first". Apidog stocke les données localement par défaut. Bruno stocke les collections sous forme de fichiers simples sur le disque. Les deux vous permettent de voir et de sauvegarder vos données sans dépendre du cloud d'un fournisseur.

Vérifiez le modèle de données avant de mettre à niveau. Lorsqu'une version majeure est publiée, lisez les notes de migration avant de mettre à jour. Si la version modifie l'emplacement ou la manière dont les données sont stockées, comprenez les implications avant de cliquer sur installer.

FAQ

Puis-je récupérer les données Insomnia sans me connecter à Kong ?Oui, si vos fichiers de base de données sont toujours sur le disque. Utilisez DB Browser for SQLite pour ouvrir le fichier .db dans votre répertoire de support d'application Insomnia et exportez les données directement depuis les tables.

Quel format dois-je utiliser lors de l'exportation des données Insomnia ?Utilisez le format JSON Insomnia v4. C'est le format le plus largement pris en charge et il peut être importé par Apidog, Postman et d'autres outils.

Mes variables d'environnement seront-elles transférées vers Apidog ?Dans la plupart des cas, oui. Les environnements Insomnia sont exportés dans le cadre du format JSON v4 et Apidog les importe. Vérifiez les environnements importés pour confirmer que les valeurs sont correctes, particulièrement pour les jetons sensibles.

Quelle est la différence entre le stockage temporaire (scratch storage) d'Insomnia et le stockage local dans d'autres outils ?Le stockage temporaire d'Insomnia était un mode de secours présentant des problèmes de fiabilité. Apidog et Bruno traitent le stockage local comme le modèle principal, et non comme un mode de secours. Les données sont écrites sur le disque à chaque sauvegarde, et non conservées en mémoire.

Puis-je utiliser DB Browser for SQLite sur macOS ?Oui. DB Browser for SQLite est disponible pour macOS via le site web du projet et via Homebrew (brew install db-browser-for-sqlite).

Combien de temps prend la migration d'Insomnia vers Apidog ?Pour une collection typique de 50 à 200 requêtes, l'importation prend moins de cinq minutes. L'examen et l'ajustement des scripts et des flux d'authentification peuvent prendre plus de temps selon la complexité.