郵便配達(dá)員：API開発とテストを簡(jiǎn)素化するための強(qiáng)力なツール

キーポイント：

• Postmanは、APIの開発とテストプロセスを簡(jiǎn)素化し、過(guò)去のAPI呼び出しを保存したり、関連するAPI呼び出しをグループ化するなどの機(jī)能を提供する強(qiáng)力なツールです。これは便利で高速です。
• API（アプリケーションプログラミングインターフェイス）は、通常、WebベースのAPIのガイドラインを設(shè)定する殘りの（表示狀態(tài)転送）フレームワークを使用して作成されます。 APIを通じて実行される4つの最も一般的な操作は、オブジェクトの表示、作成、編集、削除です。
• APIテストは、機(jī)能、例外処理、セキュリティを確保するための開発プロセスの重要な部分です。これは、Curlライブラリのコマンドラインを使用することで実行できますが、Postmanのようなツールはこのプロセスを簡(jiǎn)単にすることができます。
• Postmanを使用して、Facebook Graph APIなどのAPIにリクエストを送信でき、開発者は投稿、投稿、投稿、削除などの投稿を表示できます。このツールは、APIを使用する開発者にとって貴重な資産になる可能性があります。

ジェフ?スミスの助けをありがとう、彼はこの記事のピアレビューに參加することに熱心でした。

---

今日のSitePoint Webサイトで人気のある記事：

• HTTP/2とは何ですか？
• これら3つのCSSメソッドを使用して、制御できないスタイルシートを飼いならします
• 通常のWordPressメンテナンスリスト
• 共有サーバーホスティング：長(zhǎng)所と短所
• すべてのWebサイトにhttps
が必要なのはなぜですか

---

API（アプリケーションプログラミングインターフェイス）は、アプリケーション間の相互作用の媒體です。 HTTPまたはHTTPSを使用するAPIは、Web APIと呼ばれます。

インターネットを見(jiàn)回すと、多數(shù)のサービスがAPIを使用していることがわかります。ソーシャルログインを使用すると、eコマースWebサイトのモバイルアプリケーションが使用されています。

サービスのAPIを作成することにより、サードパーティの開発者がサービスに基づいてアプリケーションを作成できるようにすることができます。たとえば、ソーシャルニュースサイトのFrroleは、Twitter APIを使用して、多數(shù)のツイートを分析することにより、コンテキストの洞察を生成します。

APIを作成することの長(zhǎng)所と短所を評(píng)価したと仮定して、APIを作成およびテストするプロセスについて簡(jiǎn)単に説明しましょう。

api

を作成します

APIを作成するには多くの方法がありますが、Web APIは殘りの（概念狀態(tài)転送）フレームワークを使用して作成されます。 RESTフレームワークは、APIを作成するときに従う必要がある一連のガイドラインを指定します。毎日作成された多數(shù)のAPIにより、WebベースのAPIの標(biāo)準(zhǔn)になります。

APIを通じて実行される4つの最も一般的な操作は、オブジェクトの表示、作成、編集、削除です。 RESTフレームワークは、これらの操作に4つのHTTP動(dòng)詞をマッピングします：取得、投稿、配置、削除。このリストには、パージやパッチなどの多くの動(dòng)詞が追加されていますが、この記事では4つの基本動(dòng)詞のみを説明します。 Enchant.comの創(chuàng)設(shè)者Vinay Sahniによって書かれた実用的なRestful APIベストプラクティスに関する記事は、初めての開発者にとって役立つかもしれません。

今日の多くのフレームワークは、基本的なHTTPレイヤーのラッパーを提供し、開発作業(yè)を容易にします。必要なコマンドまたは関數(shù)を呼び出して関數(shù)に焦點(diǎn)を合わせるだけです。人気のある例には、SlimとToro、2つのPHPベースのミニチュアフレームワークがあり、REST APIをすばやく作成するのに役立ちます。

cli

を介してAPIをテストします

APIを作成する主な目的は、他のアプリケーション（おそらく獨(dú)自または第三者が開発した）を有効にすることです。したがって、API開発プロセスのあらゆる段階で、重要なステップは、APIの機(jī)能、例外処理、セキュリティをテストすることです。

APIを使用するには、動(dòng)詞（またはメソッド）のいずれかを使用して、目的のリソース（通常はURL）にリクエストを行うことが含まれます。使用しているAPIの要件に応じて、ヘッダーを追加する必要がある場(chǎng)合があります。そのようなリソースを要求する1つの方法は、コマンドラインを使用することです。

この記事では、API呼び出しの4つの部分（URL、HTTP動(dòng)詞、ヘッダー、およびパラメーター）に焦點(diǎn)を當(dāng)てます。 Curlライブラリを使用して、CLIを介してAPIリソースにリクエストを送信します。 Curlは、URL構(gòu)文を使用してデータを転送するのに役立つコマンドラインツールです。FTP、FTPS、HTTP、HTTPSをサポートしています。

次のコマンドを見(jiàn)てみましょう

-iコマンドは、リクエストにヘッダーが存在することをコマンドに伝えるincludeの略です。 -xオプションは、HTTP動(dòng)詞またはメソッドにすぐに従います。 -hリクエストに追加されたカスタムヘッダーを指定します。最後に、-dオプションは、リクエストに合わせて渡されるカスタムフォームデータを指定します。

<code>curl -i -X POST -H 
    "Content-Type:application/json" 
    http://www.my-api-example.com:port/ -d 
    '{"Name":"Something"}'</code>

API呼び出しの結(jié)果は、通常はJSON形式でエンコードされるHTTP応答です。応答には、リクエストステータスに関する情報(bào)を提供するHTTP応答コードが提供されます（例：200はOK、404はリソースが存在しないことを意味し、500はサーバーエラーを意味し、403はリソースが禁止されていることを意味します）。たとえば、以前のリクエストの結(jié)果として、次の回答を送信できます。

コマンドライン內(nèi)でそのような応答をテストすることは、特に応答に多數(shù)のオプションがある場(chǎng)合、チャレンジをもたらします。

CodingPediaのこの詳細(xì)なガイドは、APIをテストするときにCLIオプションリストをリストします。

<code>{"message":"success","id":"4"}</code>

Postman

によるテストを簡(jiǎn)素化します

Postmanは、API開発プロセスを高速かつ簡(jiǎn)単にする強(qiáng)力なAPI開発キットです。 Mac、Windows、LinuxのChrome拡張機(jī)能およびネイティブアプリケーションとして使用できます。 100萬(wàn)人以上の開発者がそれを試しました。 Chrome拡張機(jī)能をインストールするには、最初にChromeをインストールしてから、Chrome Webストアのプロジェクトページに移動(dòng)する必要があります。

最初に、郵便配達(dá)員を通じて以前のCLIリクエストをシミュレートする方法を理解しましょう。次の畫像は、上記の4つの部分すべてを含むPostmanでAPI呼び出しを作成することを示しています。

プレビュー（応答がHTMLの場(chǎng)合）に加えて、リクエストを通じて受け取る応答は、元の形式または美しい形でも表示できます。次の畫像は、ポストマンで応答を表示するさまざまな方法を示しています。

Postmanは、過(guò)去に作成したAPIコールを自動(dòng)的に保存します。これにより、APIをテストするときに時(shí)間を節(jié)約できます。さらに、それらはあなたの便利さのために関連するAPI呼び出しにグループ化できます。これは、Postmanを介したAPIコール履歴の例です。

Postman

を介してFacebookグラフAPIを使用しています

FacebookグラフAPIを使用して、Postmanの仕組みを示す良い方法。この投稿では、ユーザーのタイムラインの投稿、投稿の詳細(xì)を表示する方法、投稿の作成方法と削除方法に焦點(diǎn)を當(dāng)てます。

グラフAPIを使用する場(chǎng)合、アクセストークンが重要です。トークンは多くの権限に関連付けられています。たとえば、publish_actionsがトークンを生成するときに選択されたフィールドの1つである場(chǎng)合にのみ、トークンを使用して投稿を作成できます。この追加レベルのセキュリティは、Facebookを介してログインするときに特定のアプリケーションに特定のアクションを付與するのに役立ちます。

投稿を表示

グラフAPIにリクエストを送信するには、アクセストークンを生成する必要があります。トークンを生成した後、GETリクエストを次のURLに送信し、Access_Tokenをパラメーターとして使用する必要があります。

次の畫像は、詳細(xì)とともに基本的なグラフAPI呼び出しを示しています。

<code>curl -i -X POST -H 
    "Content-Type:application/json" 
    http://www.my-api-example.com:port/ -d 
    '{"Name":"Something"}'</code>

コマンドに従って、タイムラインの投稿のリストを確認(rèn)できます。

タイムラインの投稿リストの詳細(xì)がどのように表示されるかを次に示します。

<code>{"message":"success","id":"4"}</code>

単一の投稿の詳細(xì)を表示するには、次のリソースを使用します。

単一の投稿の詳細(xì)は次のとおりです。

like

<code>GET /me/</code>

が好きになると、次のURLに投稿リクエストを送信するだけです（wintがpublish_actionsが必要であることに注意してください）：

次のように、郵便配達(dá)員を介して同様のリクエストを送信します

同様に、同じURLに削除要求を送信して削除できます。

投稿を作成します

<code>GET /me/feed/</code>

投稿を作成するには、POSTリクエストに加えていくつかのパラメーターを送信する必要があります。これを行うには、publish_actionsも必要です。

次のオプションを投稿リクエストに追加できます：

• メッセージ：投稿に関連付けられたメッセージ
• リンク：外部リソースへのリンク
• 場(chǎng)所：投稿に関連する場(chǎng)所（「チェックイン」の場(chǎng)所に似ています）
• タグ：友人またはページ
• プライバシー：投稿の聴衆(zhòng)が表示される
• object_attachment：既存のFacebook投稿

ドキュメントでは、これらすべての機(jī)能がどのように使用されるかを説明しています。

自分のタイムラインまたはユーザー、ページ、イベント、またはリクエストを送信することを選択したURLに基??づいてのタイムラインに投稿を作成できます。

<code>curl -i -X POST -H 
    "Content-Type:application/json" 
    http://www.my-api-example.com:port/ -d 
    '{"Name":"Something"}'</code>

自分のタイムラインに投稿してみましょう。リクエストが成功した場(chǎng)合、作成された投稿のIDを取得します。グラフAPIを使用して新しい投稿を作成する例は次のとおりです。

投稿を編集するには、次のURLにPOSTリクエストを送信し、投稿を作成したときと同じパラメーターを使用する必要があります。

投稿を削除

<code>{"message":"success","id":"4"}</code>

wikeを削除するのと同じように、投稿を削除するには、削除リクエストをpost URLに送信する必要があります。

<code>GET /me/</code>

注：この記事では、郵便配達(dá)員には多くの有用な機(jī)能があることを見(jiàn)てきました。無(wú)料版をアップグレードした後（ライセンスごとに9.99ドル）、複數(shù)のデータ値でAPIコレクションを?qū)g行するなど、より多くの機(jī)能があります。

結(jié)論 APIを作成することは、多くの重要なステップを含む重要なタスクです。郵便配達(dá)員は、徹底的なテストプロセスを容易にします?，F(xiàn)在、郵便配達(dá)員は平均的な開発者の問(wèn)題をうまく解決しているようです。ただし、Web業(yè)界でよく見(jiàn)られるパラダイムシフトでそれがどのように進(jìn)化するかはまだわかりません。

郵便配達(dá)員の重要な特徴がありませんか？別のクライアントを使用してAPIをテストしていますか？以下のコメントでお知らせください。

郵便配達(dá)員でAPIの構(gòu)築とテストに関するよくある質(zhì)問(wèn) 郵便配達(dá)員とは何ですか？また、APIの構(gòu)築とテストにどのように役立ちますか？

Postmanは、開発者がAPIを構(gòu)築およびテストするための人気のあるツールです。 HTTPリクエストを簡(jiǎn)単に送信して応答を表示できるユーザーフレンドリーなインターフェイスを提供します。 Postmanは、Get、Post、Delete、Putなど、さまざまなタイプのHTTPリクエストをサポートしています。また、リクエストを保存し、簡(jiǎn)単にアクセスして共有できるようにコレクションに整理することもできます。 Postmanの組み込みテスト機(jī)能を使用すると、APIのテストをツール自體に直接記述することができ、API開発の包括的なソリューションになります。

郵便配達(dá)員は自由に使用できますか？

Postmanは無(wú)料の有料バージョンを提供しています。 Postman Basicと呼ばれる無(wú)料版は、個(gè)々の開発者または小チームのニーズを満たすのに十分な強(qiáng)力な機(jī)能セットを提供します。 Postmanは、高度な機(jī)能とコラボレーションを必要とする大規(guī)模なチームまたは企業(yè)向けに有料プランを提供しています。

PostmanProは基本バージョンとどう違うのですか？

Postman Proは、基本版にはない追加機(jī)能を提供する有料版です。これらには、チームコラボレーション、API監(jiān)視、高度なAPIドキュメントなどが含まれます。複雑なAPI開発プロジェクトを管理する必要があるプロの開発者とチーム向けに設(shè)計(jì)されています。

郵便配達(dá)員の購(gòu)入方法は？

公式ウェブサイトから郵便配達(dá)員を購(gòu)入できます。チームの規(guī)模と特定のニーズに基づいて、さまざまな価格設(shè)定計(jì)畫を提供します。ニーズに合った計(jì)畫を選択し、プロンプトに従って購(gòu)入を完了することができます。

ソフトウェア開発における郵便配達(dá)員の役割は何ですか？

ソフトウェア開発では、PostmanはAPI開発とテストにおいて重要な役割を果たしています。開発者は、単一のプラットフォームでAPIを構(gòu)築、テスト、および文書化できるため、開発プロセスが簡(jiǎn)素化されます。また、コラボレーションをサポートし、チームがAPIプロジェクトで一緒に作業(yè)しやすくなります。

自動(dòng)テストには郵便配達(dá)員を使用できますか？

はい、郵便配達(dá)員は自動(dòng)テストをサポートしています。 PostmanでAPIのテストを作成し、Postman's Collection RunnerまたはNewman（Postman's Command Line Tool）を使用して自動(dòng)的に実行できます。これにより、APIテストを継続的な統(tǒng)合/連続配信（CI/CD）パイプラインに統(tǒng)合しやすくなります。

PostmanでAPIリクエストを整理する方法は？

Postmanを使用すると、APIリクエストをコレクションに整理できます。コレクションは、一緒に保存できる関連するリクエストのセットです。これにより、リクエストの管理と共有が容易になります。コレクションにフォルダーを追加して、さらに組織化することもできます。

郵便配達(dá)員はさまざまなタイプの認(rèn)証をサポートしていますか？

はい、Postmanは、Basic Auth、Bearer Token、OAuth 1.0、OAuth 2.0など、さまざまな認(rèn)証タイプをサポートしています。これにより、異なる認(rèn)証要件でAPIをテストするための汎用性の高いツールになります。

ポストマンコレクションを他の人と共有できますか？

はい、郵便配達(dá)員はあなたのコレクションを他の人と共有することができます。これは、チームワークに特に役立ちます。有料版を使用している場(chǎng)合は、JSONファイルとしてエクスポートするか、郵便配達(dá)員から直接共有することにより、コレクションを共有できます。

郵便配達(dá)員を効果的に使用する方法を?qū)Wぶ方法は？

郵便配達(dá)員を?qū)Wぶための多くのリソースがあります。公式郵便局のウェブサイトは、包括的なドキュメントとチュートリアルを提供しています。また、他の郵便配達(dá)員ユーザーの経験を?qū)Wぶことができる多くのオンラインコース、ブログ、フォーラムもあります。

以上がAPIの構(gòu)築とテストにより、郵便配達(dá)員は簡(jiǎn)単になりましたの詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國(guó)語(yǔ) Web サイトの他の関連記事を參照してください。