インソムニア API クライアント

Insomnia は、GraphQL、REST、WebSocket、サーバー送信イベント (SSE)、gRPC、およびその他の HTTP 互換プロトコル用のオープンソースのクロスプラットフォーム API クライアントです。

Insomnia を使用すると、次のことが可能になります。

最も一般的なプロトコルと形式を使用してAPI をデバッグします。
ネイティブの OpenAPI エディターとビジュアルプレビューを使用してAPI を設計します。
ネイティブテストスイートとコレクションランナーを使用してAPI をテストします。
クラウドまたは自己ホスト型のモックサーバーを使用してAPI をモックします。
ネイティブの Insomnia CLI を使用してCI/CD パイプラインを構築し、リンティングとテストを行います。
多くのコラボレーション機能を使用して他のユーザーとコラボレーションします。
さらに、サードパーティのプラグインを使用する機能も含まれます。

Insomnia プロジェクト、コレクション、デザインスペック、その他すべてのリソースでは、次のストレージオプションがサポートされています。

Local Vault : コレクション、設計仕様、その他すべてのリソースを 100% ローカルに保管します。
Git Sync : クラウドを経由せずに、サードパーティの Git リポジトリを使用する Git ストレージ用。
クラウド同期: クラウドコラボレーション用。オプションでクラウド内でエンドツーエンド暗号化 (E2EE)。

無料で始めましょう

Insomnia は Mac、Windows、Linux で利用でき、次の Web サイトからダウンロードできます。

https://insomnia.rest

アカウントとサブスクリプション

Insomnia はローカルのScratch Padでアカウントなしで使用することも、無料でアカウントを作成して製品の全機能にアクセスすることもできます。

アカウントがある場合でも、Insomnia は選択したストレージバックエンド(Local Vault、Cloud Sync、Git Sync、またはそれらの組み合わせ) に従ってプロジェクトとファイルのみを保存します。そのため、たとえば、機密性の高いプロジェクトを 100% ローカルに保存するか Git リポジトリに保存するかを自由に選択でき、同時にクラウド内の他のプロジェクトと共同作業することもできます。それは両方の長所です。

セキュリティを強化するために、Insomnia はプライベート環境機能も提供します。この機能では、プロジェクト用に選択したストレージオプションとは関係なく、環境設定は常にローカルに保存され、クラウドには決して保存されません。

プレミアム機能とサポート

Insomnia には、ほとんどのユーザーにとって満足できる非常に寛大な無料プランがありますが、無制限のコラボレーション、Git Sync 機能、プロジェクト用の組織の作成機能、ログインにサードパーティの IDP を使用する機能などのプレミアム機能にアクセスする必要がある場合は、 (SAML、OIDC) やその他の多くの機能がある場合は、他のサブスクリプションプランを検討できます。

すべてのサブスクリプションプランを比較し、無料で始めることができます。

Insomnia にはなぜアカウントが必要ですか?

Insomnia では、ローカルのスクラッチパッドを使用する場合はアカウントは必要ありませんが、製品のほとんどの機能にアクセスするにはアカウントが必要です。お客様のアカウントデータは、ISO27001、SOC 2 Type II、ISO27018、Gold CSA STAR 規制に準拠し、当社の利用規約およびプライバシーポリシーに従って安全に保存されます。

製品を持続的に構築および改善し、無料のオープンソースディストリビューションで多くのコア機能を提供し続けることができるようにするには、アカウントが必要です。オープンソースソフトウェアは無料で使用できますが、残念ながらビルドは無料ではありません。Insomnia への取り組みを継続できるかどうかは、一部の無料ユーザー (プレミアム機能が必要なユーザー) を当社製品の有料顧客に変換できるかどうかにかかっています。。

コレクションや設計仕様などの API データをクラウドに共有できないユーザーの場合でも、Insomnia プロジェクトのストレージとして「Local Vault」を選択することでこれが可能です。Insomnia アカウントの所有は、保存方法に関連付けられません。機密性の高い API データ (Local Vault 経由で 100% ローカルに保存することも、Git Sync 経由でクラウドストレージを使用せずにサードパーティの Git リポジトリに保存することも、Cloud Sync 経由で共同作業を容易にするためにクラウドに保存することもできます)。

バグと機能リクエスト

バグや機能リクエストがありますか?まず、問題のガイドラインを読み、既存の問題と解決済みの問題を検索します。問題やアイデアがまだ解決されていない場合は、新しい問題を開いてください。

製品に関する一般的な質問やフィードバックについては、Slack チームに参加してください。

貢献する

私たちの貢献ガイドラインと行動規範を必ずお読みください。問題を開くための指示、コーディング標準、開発上の注意事項が含まれています。

ドキュメント

弊社の公式 Insomnia ドキュメントをご覧ください。

不眠症を発症する

Node.js と Git があれば、Insomnia での開発は Mac、Windows、または Linux 上で行うことができます。正しいノードバージョンについては、プロジェクト内にある.nvmrcファイルを参照してください。

初期開発セットアップ

このリポジトリはモノリポジトリとして構造化されており、多くの Node.JS パッケージが含まれています。各パッケージには独自のコマンドセットがありますが、最も一般的なコマンドはルートのpackage.jsonから入手でき、 npm run …コマンドを使用してアクセスできます。アプリの開発を開始するために必要なコマンドは次の 3 つだけです。

 # 依存関係のインストールとリンクnpm i# lint の実行npm run lint# タイプチェックの実行npm run type-check# テストの実行npm test# ライブリロードでアプリを起動npm run dev

Linux

Linux を使用している場合は、次のサポートパッケージをインストールする必要がある場合があります。

Ubuntu/Debian

 # ライブラリを更新しますsudo apt-get update# フォント設定ライブラリをインストールし、サポートしますudo apt-get install libfontconfig-dev

フェドーラ

# libcurl をノードにインストールします-libcurlsudo dnf install libcurl-devel

Linux でも、インストールプロセス中に Electron が失敗した場合は、次のコマンドを実行します。

 # Electron インストールの競合をクリアrm -rf ~/.cache/electron

窓

Windows を使用していて問題が発生した場合は、Windows ビルドツールのインストールが必要になる場合があります。

編集者の要件

任意のエディターを使用できますが、次のツールのサポート/プラグインがあることを確認してください。

ESLint - 構文の問題と一般的なエラーを検出するための
JSX 構文 - React コンポーネントの場合

Inso CLIの開発

npm i
コンパイラを監視モードで起動します: npm run inso-start
実行: ./packages/insomnia-inso/bin/inso -v

プラグイン

Insomnia Plugin Hub からプラグインを検索、発見、インストールします。

コミュニティプロジェクト

Insomnia Documenter - ドキュメンタプラグインまたは Insomnia エクスポートファイルを使用して、美しい API ドキュメントページを生成します。
GitHub API Spec Importer - Insomnia に直接インポートできる GitHub REST API ルート仕様の完全なセット。
Swaggymnia - Insomnia で既存の API の Swagger ドキュメントを生成します。