insomnie
10.1.1
Insomnia est un client API multiplateforme open source pour GraphQL, REST, WebSockets, les événements envoyés par le serveur (SSE), gRPC et tout autre protocole compatible HTTP.
Avec Insomnia, vous pouvez :
Déboguez les API en utilisant les protocoles et formats les plus populaires.
Concevez des API à l'aide de l'éditeur natif OpenAPI et de l'aperçu visuel.
Testez les API à l’aide de suites de tests natives et d’un exécuteur de collection.
Mockez des API à l’aide d’un cloud ou d’un serveur moqueur auto-hébergé.
Créez des pipelines CI/CD à l’aide de la CLI native d’Insomnia pour le peluchage et les tests.
Collaborez avec d’autres en utilisant les nombreuses fonctionnalités de collaboration.
Et bien plus encore, notamment la possibilité d’utiliser des plugins tiers.
Les options de stockage suivantes sont prises en charge pour vos projets, collections, spécifications de conception et toutes les autres ressources Insomnia :
Local Vault : pour un stockage 100 % local des collections, des spécifications de conception et de toutes les autres ressources.
Git Sync : pour le stockage Git en utilisant n'importe quel référentiel Git tiers, sans passer par le cloud.
Cloud Sync : pour la collaboration cloud, éventuellement chiffré de bout en bout (E2EE) dans le cloud.
Insomnia est disponible pour Mac, Windows et Linux et peut être téléchargé depuis le site Web :
https://insomnie.rest
Vous pouvez utiliser Insomnia sans compte avec le Scratch Pad local, ou vous pouvez créer un compte gratuitement pour accéder à toutes les fonctionnalités du produit.
Même avec un compte, Insomnia stocke uniquement vos projets et fichiers en fonction du backend de stockage que vous avez sélectionné, qui peut être Local Vault, Cloud Sync, Git Sync ou toute combinaison de ceux-ci. Ainsi – par exemple – vous avez la liberté de choisir de stocker des projets sensibles 100 % localement ou dans un dépôt Git, tout en pouvant collaborer sur d’autres dans le cloud. C'est le meilleur des deux mondes.
Pour plus de sécurité, Insomnia propose également une fonctionnalité d'environnements privés , où la configuration de votre environnement est toujours stockée localement et jamais dans le cloud, indépendamment de l'option de stockage que vous avez choisie pour votre projet.
Insomnia propose un plan gratuit très généreux qui conviendra à la plupart des utilisateurs, mais si vous avez besoin d'accéder à des fonctionnalités premium telles que la collaboration illimitée, la fonctionnalité Git Sync, la possibilité de créer des organisations pour vos projets, en utilisant un IDP tiers pour les connexions. (SAML, OIDC) et de nombreuses autres fonctionnalités, vous pouvez alors explorer les autres plans d'abonnement.
Vous pouvez comparer tous les plans d'abonnement et commencer gratuitement.
Insomnia ne nécessite pas de compte si vous décidez d'utiliser le Scratch Pad local, mais pour accéder à la plupart des fonctionnalités du produit, nous avons besoin d'un compte. Les données de votre compte sont stockées en toute sécurité conformément aux réglementations ISO27001, SOC 2 Type II, ISO27018, Gold CSA STAR et conformément à nos conditions de service et à notre politique de confidentialité.
Nous avons besoin d'un compte pour créer et améliorer le produit de manière durable, et pour nous assurer que nous pouvons continuer à offrir les nombreuses fonctionnalités de base dans une distribution gratuite et open source. Bien que l'utilisation des logiciels open source soit gratuite, leur construction n'est malheureusement pas gratuite, et notre capacité à continuer à travailler sur Insomnia dépend de notre capacité à convertir un sous-ensemble d'utilisateurs gratuits (qui ont besoin de fonctionnalités premium) pour devenir des clients payants de notre produit. .
Si vous êtes un utilisateur qui ne peut pas partager des données API telles que des collections et des spécifications de conception dans le cloud, cela est toujours possible en sélectionnant « Local Vault » comme stockage de vos projets Insomnia : avoir un compte Insomnia n'est pas lié à la manière dont vous souhaitez stocker. vos données API sensibles (qui peuvent être stockées à 100 % localement via Local Vault, sur un référentiel Git tiers sans aucun stockage cloud via Git Sync, ou dans le cloud pour faciliter la collaboration via Cloud Sync).
Vous avez un bug ou une demande de fonctionnalité ? Tout d’abord, lisez les directives relatives aux problèmes et recherchez les problèmes existants et clos. Si votre problème ou votre idée n'est pas encore résolu, veuillez ouvrir un nouveau numéro.
Pour des questions et des commentaires plus génériques sur les produits, rejoignez l’équipe Slack.
Veuillez lire nos directives de contribution et notre code de conduite. Sont inclus des instructions pour l'ouverture des numéros, des normes de codage et des notes sur le développement.
Consultez notre documentation officielle sur l'insomnie.
Le développement sur Insomnia peut être effectué sur Mac, Windows ou Linux tant que vous disposez de Node.js et de Git. Consultez le fichier .nvmrc situé dans le projet pour connaître la version correcte de Node.
Ce référentiel est structuré comme un monorepo et contient de nombreux packages Node.JS. Chaque package possède son propre ensemble de commandes, mais les commandes les plus courantes sont disponibles à partir de la racine package.json et sont accessibles à l'aide de la commande npm run … . Voici les trois seules commandes dont vous devriez avoir besoin pour commencer à développer sur l'application.
# Installer et lier les dépendancesnpm i# Exécuter Lintnpm run lint# Exécuter la vérification du typenpm run type-check# Exécuter Testsnpm test# Démarrer l'application avec Live Reloadnpm run dev
Si vous utilisez Linux, vous devrez peut-être installer les packages de prise en charge suivants :
# Mettre à jour la bibliothèque sudo apt-get update # Installer la bibliothèque de configuration des polices et prendre en charge sudo apt-get install libfontconfig-dev
# Installez libcurl pour node-libcurlsudo dnf install libcurl-devel
Également sous Linux, si Electron échoue pendant le processus d'installation, exécutez ce qui suit
# Effacer les conflits d'installation d'Electronrm -rf ~/.cache/electron
Si vous êtes sous Windows et rencontrez des problèmes, vous devrez peut-être installer Windows Build Tools
Vous pouvez utiliser n'importe quel éditeur de votre choix, mais assurez-vous de disposer du support/des plugins pour les outils suivants :
ESLint - Pour détecter les problèmes de syntaxe et les erreurs courantes
Syntaxe JSX - Pour les composants React
npm i
Démarrez le compilateur en mode surveillance : npm run inso-start
Exécutez : ./packages/insomnia-inso/bin/inso -v
Recherchez, découvrez et installez des plugins à partir du Insomnia Plugin Hub !
Insomnia Documenter - Générez de superbes pages de documentation API à l'aide du plugin Documenter ou de votre fichier d'exportation Insomnia.
GitHub API Spec Importer - Un ensemble complet de spécifications de route de l'API GitHub REST qui peuvent être importées directement dans Insomnia.
Swaggymnia - Générez de la documentation Swagger pour votre API existante dans Insomnia.
Apache-2.0 © Insomnie
