gRPCサービスを利用している方なら、一般的なAPIツールの限界にぶつかったことがあるでしょう。多くのクライアントはgRPCを後付けで扱っていますが、Kreyaは逆のアプローチを取っています。gRPCを中心として据え、その周りに他のプロトコルを構築しています。
このガイドでは、Kreyaとは何か、その優れた点、どのように作業を保存するか、そしてどのようなユーザーに適しているかを説明します。読み終える頃には、あなたのワークフローに合っているかどうかがわかるでしょう。
始める前に一つだけ注意点があります。この記事で取り上げるKreyaは、riok GmbHが開発したAPIクライアントで、kreya.appで提供されています。同名のファッションブランドやビューティーブランドではありません。もし衣類をお探しでしたら、場所を間違えています。
ボタンボタン
Kreyaとは？
Kreyaは、スイスに拠点を置くソフトウェア会社riok GmbHによって開発されたデスクトップGUI APIクライアントです。複数のプロトコルを横断してAPIを呼び出し、テストするためのグラフィカルインターフェースを提供します。
gRPC、REST、GraphQL、WebSocket、Server-Sent Eventsをサポートしており、現代のバックエンド開発者が日々触れるほとんどのプロトコルをカバーしています。一度インストールすれば、これらのプロトコルすべてを単一のウィンドウから呼び出すことができます。
Kreyaはフリーミアムモデルのプロプライエタリソフトウェアです。コアクライアントは無料で利用できます。有料プランでは、個人やチーム向けの高度な機能が追加されます。料金体系については後ほど説明します。
この製品は、macOS、Windows、Linux上でネイティブデスクトップアプリとして動作します。ブラウザ版はなく、クラウドアカウントも不要です。ダウンロードしてインストールするだけで、すぐにAPIを呼び出すことができます。
gRPCファーストのポジショニング
ほとんどのAPIクライアントはRESTツールとして始まり、後からgRPCを追加しました。しかも、それが薄いレイヤーであることも少なくありません。Kreyaはその順序を逆転させています。gRPCのサポートは深く、後付けではありません。
サービスを読み込む方法は2つあります。直接`.proto`ファイルをインポートするか、gRPCサーバーリフレクションを使用して実行中のサーバーからサービス定義を取得します。リフレクションを使用すると、常にprotoファイルを手元に用意する必要がありません。サーバーがそれらを公開していれば、Kreyaが読み取ってくれます。
あらゆるgRPC呼び出しタイプを処理します。これには、単項リクエスト、クライアントストリーミング、サーバーストリーミング、双方向（二重）ストリーミングが含まれます。多くのツールが単項呼び出しで止まってしまう中、Kreyaは全範囲をカバーしており、実際のストリーミングサービスを構築する際にはこれが重要になります。
内部的には、gRPCが依存するHTTP/2をサポートしています。HTTP/1.1およびHTTP/3もサポートしています。プロトコル自体に焦点を当てた入門書が必要な場合は、当社のgRPCクライアントガイドと、gRPC APIをテストする方法のチュートリアルをご覧ください。
マルチプロトコル対応
gRPCが目玉ですが、Kreyaは単一プロトコルツールではありません。通常の構築中に利用する一般的なプロトコルを扱えます。
RESTの場合、メソッド、ヘッダー、クエリパラメータ、ボディを使ってリクエストを構成し、レスポンスを検査します。これはAPI作業の基本中の基本です。REST APIクライアントの概要は、初めての方のためにこのカテゴリを説明しています。
GraphQLの場合、GraphQLエンドポイントに対してクエリとミューテーションを送信し、構造化されたレスポンスを読み取ります。もしGraphQLがあなたの主要なプロトコルであるなら、最高のGraphQLクライアントのまとめが、より広い視野を提供します。
リアルタイム作業のために、KreyaはWebSocketとServer-Sent Eventsをサポートしています。WebSocketは双方向チャネルを提供し、SSEはサーバーからクライアントへの一方向ストリームを提供します。どちらもライブデータフィードやチャットスタイルのサービスをテストする際に役立ちます。
特定のジョブにどのプロトコルを選択すべきか迷う場合は、REST vs GraphQL vs gRPCの比較がトレードオフを詳しく説明しています。
オフライン、プライバシーファースト、Gitで差分比較可能なストレージ
3つの設計上の選択が、Kreyaをクラウドファーストのツールとは一線を画しています。これらは特に厳格なデータ規則を持つチームにとって最も重要となる傾向があります。
完全オフラインで動作
Kreyaはインターネット接続なしであなたのマシン上で動作します。あなたのリクエスト、環境、レスポンスはローカルに保持されます。リクエストを送信するためにクラウドサービスにサインインする必要はありません。ファイアウォールの内側や機密システムで作業する開発者にとって、これは大きな利点です。このカテゴリの詳細については、最高のオフラインAPIクライアントオプションに関するガイドをご覧ください。
デフォルトでプライバシーファースト
すべてのデータがあなたのデバイスに留まるため、デフォルトであなたのAPIデータがあなたの管理を離れることはありません。リクエストボディをベンダーサーバーに送信するテレメトリーはありません。Kreyaは自らをプライバシーファーストと謳っており、デフォルトでオフラインの設計がそれを裏付けています。エンタープライズのオフラインライセンスは、ロックダウンされた環境でアカウント要件を完全に削除することができます。
Gitで差分比較可能なプロジェクトストレージ
これはエンジニアリングチームを納得させる機能です。Kreyaは各プロジェクトを、ディスク上のプレーンな構造化されたJSONファイルとして保存します。これらのファイルはGitで差分比較可能なので、他のコードと同様にリポジトリにコミットできます。
その結果、真のバージョン管理が可能になります。プルリクエストでAPIの変更をレビューできます。チームメイトがリクエストに何を変更したかを正確に確認できます。`git revert`で間違った編集を元に戻すことができます。プロプライエタリな同期形式があなたとあなたの履歴の間に挟まることはありません。
これにより、Kreyaは他のGitネイティブAPIクライアントと同じファミリーに属します。あなたのチームがすでにGitを使用しているなら、API定義もそこに存在します。
テストと自動化
Kreyaは単なる探索ツールではありません。APIが時間の経過とともに正しく動作することを検証するのにも役立ちます。
自動テストをサポートしています。JavaScriptでスクリプト化されたテストを作成し、レスポンスをアサートできます。一連の入力に対して反復するデータ駆動型テストを実行することも可能です。これにより、アドホックなチェックが再現可能なテストスイートに変わります。
また、スナップショットテストも提供しています。スナップショットはベースラインのレスポンスをキャプチャします。次の実行時に、Kreyaはライブレスポンスとベースラインを比較し、ずれがあればフラグを立てます。これにより、API契約に対する偶発的な変更が本番環境に到達する前に検出できます。
継続的インテグレーションのために、KreyaはJUnitスタイルのレポート機能を備えたCLI自動化を提供します。保存したテストをパイプラインで実行し、その結果をCIダッシュボードにフィードします。これにより、ローカルテストとビルドシステム間のループが閉じられます。
フリーミアムモデル
Kreyaは3つのティアでフリーミアム価格モデルを採用しています。正確な金額は変更される可能性があるため、コミットする前に公式のKreya料金ページを確認してください。
無料プランは永続的に無料です。gRPC、REST、GraphQL、WebSocketなどのコアプロトコルと、基本的な認証方法をカバーしています。個人的な探索や日常的なリクエスト作業であれば、無料ティアで十分です。
プロプランは個人を対象としています。スクリプティング、スナップショットテスト、コレクション、リクエスト履歴、メールサポートなどの高度な機能が追加されます。自動テストに依存している場合、このティアへと成長していくことになります。
エンタープライズプランは企業を対象としています。優先サポート、顧客ポータル、無制限ユーザー向けの定額料金、アカウントを使用できない環境向けのオフラインライセンスオプションが追加されます。
通常、有料プランでは、購入前に高度な機能を試せる短いトライアルが提供されます。
Kreyaが適しているユーザー
Kreyaは明確なプロファイルに合致します。以下のいずれかに当てはまる場合、強力な選択肢となります。
- gRPCを多用する開発者。 バックエンドがgRPCで動作している場合、Kreyaのリフレクションサポートと完全なストリーミングカバーは自然な選択肢となります。
- プライバシーを重視するチーム。 データがマシンから離れることが許されない場合、オフラインでローカルファーストの設計は実際の問題を解決します。
- Git中心のチーム。 API定義をプルリクエストでレビューしたい場合、Gitで差分比較可能なストレージはワークフローにスムーズに適合します。
- マルチプロトコルを使用する企業。 1日にgRPC、REST、WebSocketフィードをすべて扱う場合、これらすべてを処理できる単一のツールはコンテキストスイッチングを減らします。
ホスト型のブラウザベースのワークスペースが必要な場合、またはチーム全体がMac、Windows、Webを横断して作業し、共有クラウドドキュメントを望む場合は、あまり適していません。Kreyaは設計上、デスクトップファーストです。
Apidogの立ち位置
Kreyaは、本格的なgRPCの深みを持つ、集中的でプライバシーファーストなAPIクライアントです。ローカルデスクトップツールからAPIを呼び出し、テストするだけで十分であれば、その役割を十分に果たします。
しかし、一部のチームはクライアント以上のものを求めています。APIを設計し、バックエンドが存在する前にモックし、コンシューマ向けに文書化し、リアルタイムで共同作業することを望んでいます。それは異なる範囲の機能です。
Apidogは、そのより広い範囲のために構築されたオールインワンAPIプラットフォームです。Kreyaと同様に、gRPC、REST、GraphQL、WebSocket（さらにSOAPやSocket.IO）を扱えます。クライアント機能に加えて、ビジュアルなOpenAPIデザイナー、Apidog CLIを介したCI/CDによる自動テストシナリオ、スマートモック、自動生成されるインタラクティブなドキュメント、共有チームワークスペースが追加されています。Windows、Mac、Linux用のデスクトップアプリ、Webアプリ、CLIとして提供されます。
正直なトレードオフとして、Kreyaはより軽量で、デフォルトでオフラインファーストであり、一部のチームにはこれが好まれます。一方、Apidogは、クライアント機能に加えて設計、モック、ドキュメント、コラボレーションが必要な場合に、APIライフサイクル全体を1か所でカバーします。どちらのオプションを検討している場合でも、Postmanの代替に関するまとめや、より広範な優れたAPIクライアントのリストが両方を文脈に置いています。
ボタン
よくある質問
Kreyaは無料ですか？
はい。Kreyaには、gRPC、REST、GraphQL、WebSocket、基本的な認証をカバーする永続無料プランがあります。有料のProおよびEnterpriseティアでは、スクリプティング、スナップショットテスト、チームサポートが追加されます。
Kreyaはオープンソースですか？
いいえ。Kreyaはriok GmbHが開発したプロプライエタリソフトウェアです。無料ティアで利用可能ですが、ソースコードは公開されていません。オープンソースが重要であれば、無料のオープンソースAPIクライアントオプションを検討してください。
Kreyaはオフラインで動作しますか？
はい。Kreyaは完全にオフラインで動作するデスクトップアプリです。プロジェクト、環境、レスポンスはすべてあなたのマシン上に保存されます。リクエストを送信するためにクラウドアカウントは必要ありません。
Kreyaはどのプロトコルをサポートしていますか？
KreyaはgRPC、REST、GraphQL、WebSocket、Server-Sent Eventsをサポートしています。gRPCのサポートが最も深く、プロトファイルのインポート、サーバーリフレクション、および4種類のストリーミング呼び出しタイプに対応しています。
Kreyaはバージョン管理をどのように扱いますか？
Kreyaは各プロジェクトをディスク上のGitで差分比較可能なJSONファイルとして保存します。これらをリポジトリにコミットし、プルリクエストで変更をレビューし、標準のGitコマンドで編集を元に戻すことができます。
Kreya APIクライアントはKreyaファッションブランドと関連がありますか？
いいえ。ここで説明するKreyaは、kreya.appで提供されているriok GmbH製のAPIクライアントです。同名のファッションブランドやビューティーブランドとは一切関係ありません。