ここまでAPIおよびWeb APIの概要について述べたが、ここからはWeb APIの活用、特に昨今よく使われているRESTful APIを活用する際に必要なタスクについて説明する。

API仕様の確認

　API活用に当たり、まず必要になるタスクは、API提供者が提供するAPIの仕様の確認および試験的な利用だ。

・リクエストフォーマット、パラメーターの確認

　API提供者が公開しているAPIレファレンスには、HTTPメソッドやURIだけでなく、APIコール時に受け入れ可能なリクエストフォーマットおよびパラメーターが記載されている。リクエストフォーマットはクエリストリング（URIの末尾にパラメーターを記載するフォーマット）なのかJSONなのか、XMLなのかといったことを調査する。昨今では、音声ファイルや画像ファイルといったバイナリファイルが利用可能なAPIも提供されているため、音声ファイルのビットレート、画像ファイルのピクセル数も考慮する必要がある。

　リクエストパラメーター（JSONデータやXMLデータに記載するキーやタグ名）には必須パラメーターとオプションパラメーターが指定されていることがあるので、これらも考慮する。

・レスポンスの確認

　リクエストと同様の観点で、正常時および異常時のレスポンスフォーマットとパラメーターについてAPIレファレンスで確認する。加えて正常時、異常時のHTTPステータスコードを確認し、APIコールが正常に完了したのか、異常時にどのような異常が発生したのかを判別可能にしておく。

・認証方式の確認

　APIの利用に当たり、認証が不要なAPIと必要なAPIが存在する。APIの認証として、主に3つの認証方式（Basic方式、APIキー方式、OAuth方式）が存在するため、どの認証方式を取るのかを確認する。

　これらの認証方式は、HTTPリクエストヘッダやリクエストボディー、URIのパラメーターに組み込む認証情報に違いがある。Basic方式は、ユーザー名とパスワードを直接組み込む。APIキー方式で組み込むのは、API提供者が払い出した「APIキー」と呼ばれる認証情報だ。OAuth方式は、認証用サーバから「アクセストークン」と呼ばれる認証情報を取得し、そのアクセストークンを組み込む。

・API利用が有償かどうかの確認

　APIの中には、有償のAPIが存在する。有償APIの利用を検討している場合、課金方式の確認が必要となる。課金方式には、コール数課金（APIコール数ごとに利用料がかかる）やトラフィック課金（APIコール時に送出したデータ量に応じた利用料がかかる）などが存在する。

・APIテストツールを利用したAPIの試験的な利用

　ある程度、API仕様を把握したらAPIの試験的な利用を始める。簡易なAPIであれば、Webブラウザ機能で十分だ。リクエストパラメーターが多くかつ複雑だったり、複数のAPIを組み合わせたりしたい場合はWebブラウザでは実現が難しいため、APIテストツールを利用するのが適切である。

自社サービスに他社APIを組み込む

　API仕様の確認が完了し、APIの試験的な利用でも問題がない場合、いよいよ自社サービスへのAPIの組み込みを実施する。このタイミングにおいても、幾つか考慮する点が存在する。

・API提供者からのSDK／クライアントライブラリ提供の有無の確認

　自社サービスを実現しているアプリケーションからAPIコールするためには、自前でHTTP／HTTPSでAPIをコールするモジュールを作り込む、もしくはAPI提供者のSDK（ソフトウェア開発キット）／クライアントライブラリを利用する方法が存在する。後者のSDK／クライアントライブラリを利用することで開発を効率化できるため、もし存在すれば積極的に活用する。

・API提供者のAPIライフサイクルの確認

　API提供者の戦略のためにAPI仕様が変更され、自社サービスに不具合が発生することがある。こうした事態を防ぐためには、APIライフサイクルをAPI提供者に確認することは必須だ。API仕様の変更予定があれば、猶予期間の設定や新旧APIの並行提供を打診しておく必要がある。

・API提供者のAPI利用不可時における対処法の整理

　自社サービスにAPI提供者のAPIを組み込むことは、そのAPIに自社サービスのサービスレベルが依存することに他ならない。そのため、API提供者のAPIが利用不可になる場合のアプリケーションレベルでの対処（APIが利用不可でも他機能は正常動作する）や、ドキュメントレベル（規約・免責事項）での対処を実施しておく必要がある。