RESTful APIを記述するための3つの最高のツール







APIを使用したさまざまなサービスの相互作用は、イノベーションから日常生活に変わります。 無料および有料のAPIの数はすでに数千にのぼり、その数は日々活発に増加しています。 どうして? 革新的なサービスへのリモートリクエストの販売は、サイトを通じてサービスを配信するよりも多くの利益をもたらす可能性があります。 そして、この場合、あなたの顧客はすでに頭を悩ませ、視聴者を引き付けるためにお金を使っています。 私の経験を使用して、これまでの最高のAPI実装ソリューションの概要を簡単に説明します。



このセグメントでは、スタートアップは人気への急速な動きを始めたばかりです。 新しいソフトウェアソリューションが定期的に表示されます。 ベータテストモードで動作する既存の製品は、無料サービスを利用して新しいユーザーを引き付けます。



それにもかかわらず、明確なレースリーダーがすでに登場しています。これについては、以下で詳しく説明します。









www.mashape.com

このプロジェクトは他の多くのプロジェクトとは異なります。 その主なタスクは説明ではなく、既製のソリューションのカタログを通じてAPIを販売することです。 サービスは各クライアントのサブドメインを作成し、プロキシ用のAPIへの実際のパスを隠します。 Mashapeは、そのディレクトリにAPIを配置します。 各ユーザーは、関税デザイナーを使用して、すべてのリクエストでお金を稼ぐことができます。 リクエストのプロキシにより、Mashapeはレコードを保持し、APIへのアクセスを制限できます。

Mashapeには実際のマークアップ言語はありません。すべてがブラウザーウィンドウで構成されます。 作成されたAPIの便利なテスト機能が利用可能です。

このプロジェクトは、リクエストとレスポンスの基本的なSDKを開発し、別のプロジェクトwww.unirest.ioとして公開しました。

人気のPinterestサイトのAPIの例を挙げましょう: www.mashape.com/ismaelc/pinterest-1

便利なジェネレーターを使用すると、PHP、Java、Node.js、Python、Objective-C、Ruby、.NETなどのプログラミング言語のAPIへの簡略化されたリクエストのコードをすぐに取得できます。









www.swagger.io

Swaggerはかなり前から開発されています。 ドキュメントを生成するためのこのソフトウェアソリューションは、事実上のリーダーです。 しかし、私は別の意見がありました。

JSONはマークアップとして使用されます。 プロジェクトには独自のエディター( http://editor.swagger.io/ )があります。 バージョン2.0エディターが利用可能になりました。

ディスプレイの例は、リンクで見ることができます: petstore.swagger.io

ビューアの利点には、リモートリンクからドキュメントを再生できることが含まれます。

ドキュメントを表示する場合、パラメータを使用してテストリクエストを送信するためのフォームがあります。









www.apiary.io

Apiaryは、マークダウン構文に基づいて開発されたブループリントAPIをマークアップとして使用します。 ドキュメントファイルは、Markdownのエディターによって管理されています。

プロジェクトには優れたオンラインエディターがあります。 サイトのレイアウトには顕著なバグがありますが、一部の場所では十分に考慮されていません。 それにもかかわらず、Swaggerの方がはるかに見栄えがよくなります(ただし、これは私の主観的な評価です)。

Java、Javascript、Node.js、Perl、Pythonなどの言語のクエリ例の生成をサポートします。 PHP、Ruby、Go、C#、Visual Basic、Groovy、Objective-C、Swift。



ボーナス:プロジェクトを書いてgithubに投稿しますか? その後、RESTful APIとそのSDKがwww.sdks.ioですでに利用可能です このサービスは、RESTful APIを使用して新しいファイルの出現を定期的に監視し、それらのSDKライブラリを自動的に生成します。



現在、RESTful APIの機能が異なる少なくとも20の異なるソフトウェアソリューションがあります。 この記事の本質は、このセグメントのリーダーの概要を説明することでした。 このトピックをより深く研究することに興味がある場合は、このトピックに関する他の記事を読むことができます。






All Articles