ホームページ > テクノロジー周辺機器 > IT業界 > APIの構築とテストにより、郵便配達員は簡単になりました

APIの構築とテストにより、郵便配達員は簡単になりました

Lisa Kudrow
リリース: 2025-02-19 11:25:11
オリジナル
1032 人が閲覧しました

郵便配達員:API開発とテストを簡素化するための強力なツール

キーポイント:

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

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


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

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

API Building and Testing Made Easier with Postman

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

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

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

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

api

を作成します

APIを作成するには多くの方法がありますが、Web APIは残りの(概念状態転送)フレームワークを使用して作成されます。 RESTフレームワークは、APIを作成するときに従う必要がある一連のガイドラインを指定します。毎日作成された多数のAPIにより、WebベースのAPIの標準になります。

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

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

cli

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

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

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

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

次のコマンドを見てみましょう

-iコマンドは、リクエストにヘッダーが存在することをコマンドに伝えるincludeの略です。 -xオプションは、HTTP動詞またはメソッドにすぐに従います。 -hリクエストに追加されたカスタムヘッダーを指定します。最後に、-dオプションは、リクエストに合わせて渡されるカスタムフォームデータを指定します。
<code>curl -i -X POST -H 
    "Content-Type:application/json" 
    http://www.my-api-example.com:port/ -d 
    '{"Name":"Something"}'</code>
ログイン後にコピー
ログイン後にコピー
ログイン後にコピー

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

コマンドライン内でそのような応答をテストすることは、特に応答に多数のオプションがある場合、チャレンジをもたらします。

CodingPediaのこの詳細なガイドは、APIをテストするときにCLIオプションリストをリストします。
<code>{"message":"success","id":"4"}</code>
ログイン後にコピー
ログイン後にコピー
ログイン後にコピー

Postman

によるテストを簡素化します

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

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

API Building and Testing Made Easier with Postman プレビュー(応答がHTMLの場合)に加えて、リクエストを通じて受け取る応答は、元の形式または美しい形でも表示できます。次の画像は、ポストマンで応答を表示するさまざまな方法を示しています。

API Building and Testing Made Easier with Postman

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

API Building and Testing Made Easier with Postman

Postman

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

FacebookグラフAPIを使用して、Postmanの仕組みを示す良い方法。この投稿では、ユーザーのタイムラインの投稿、投稿の詳細を表示する方法、投稿の作成方法と削除方法に焦点を当てます。

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

投稿を表示

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

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

<code>curl -i -X POST -H 
    "Content-Type:application/json" 
    http://www.my-api-example.com:port/ -d 
    '{"Name":"Something"}'</code>
ログイン後にコピー
ログイン後にコピー
ログイン後にコピー

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

API Building and Testing Made Easier with Postman タイムラインの投稿リストの詳細がどのように表示されるかを次に示します。

<code>{"message":"success","id":"4"}</code>
ログイン後にコピー
ログイン後にコピー
ログイン後にコピー
単一の投稿の詳細を表示するには、次のリソースを使用します。

単一の投稿の詳細は次のとおりです。

API Building and Testing Made Easier with Postman

like

<code>GET /me/</code>
ログイン後にコピー
ログイン後にコピー
が好きになると、次のURLに投稿リクエストを送信するだけです(wintがpublish_actionsが必要であることに注意してください):

次のように、郵便配達員を介して同様のリクエストを送信します API Building and Testing Made Easier with Postman

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

投稿を作成します
<code>GET /me/feed/</code>
ログイン後にコピー

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

次のオプションを投稿リクエストに追加できます:API Building and Testing Made Easier with Postman

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

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

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

<code>curl -i -X POST -H 
    "Content-Type:application/json" 
    http://www.my-api-example.com:port/ -d 
    '{"Name":"Something"}'</code>
ログイン後にコピー
ログイン後にコピー
ログイン後にコピー
自分のタイムラインに投稿してみましょう。リクエストが成功した場合、作成された投稿のIDを取得します。グラフAPIを使用して新しい投稿を作成する例は次のとおりです。

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

投稿を削除

<code>{"message":"success","id":"4"}</code>
ログイン後にコピー
ログイン後にコピー
ログイン後にコピー
wikeを削除するのと同じように、投稿を削除するには、削除リクエストをpost URLに送信する必要があります。

<code>GET /me/</code>
ログイン後にコピー
ログイン後にコピー

注:この記事では、郵便配達員には多くの有用な機能があることを見てきました。無料版をアップグレードした後(ライセンスごとに9.99ドル)、複数のデータ値でAPIコレクションを実行するなど、より多くの機能があります。 API Building and Testing Made Easier with Postman

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

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

郵便配達員でAPIの構築とテストに関するよくある質問 郵便配達員とは何ですか?また、APIの構築とテストにどのように役立ちますか?

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

郵便配達員は自由に使用できますか?

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

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

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

郵便配達員の購入方法は?

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

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

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

自動テストには郵便配達員を使用できますか?

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

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

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

郵便配達員はさまざまなタイプの認証をサポートしていますか?

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

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

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

郵便配達員を効果的に使用する方法を学ぶ方法は?

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

以上がAPIの構築とテストにより、郵便配達員は簡単になりましたの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。

このウェブサイトの声明
この記事の内容はネチズンが自主的に寄稿したものであり、著作権は原著者に帰属します。このサイトは、それに相当する法的責任を負いません。盗作または侵害の疑いのあるコンテンツを見つけた場合は、admin@php.cn までご連絡ください。
著者別の最新記事
人気のチュートリアル
詳細>
最新のダウンロード
詳細>
ウェブエフェクト
公式サイト
サイト素材
フロントエンドテンプレート