メトロポリタン美術館の API にクエリを実行する
ここまでは、API のしくみを十分に理解するために、ローカル コンピューターで動作する API をビルドしました。 次に、最初の API にクエリを実行して、実際のサードパーティ API (ニューヨークのメトロポリタン美術館の API) 内にあるオブジェクトを検索します。
最新の美術館コレクション管理の優れている点の 1 つは、コレクションをデジタル化してオンラインで公開する取り組みが進んでおり、一般の美術愛好家もそのデータにアクセスできるようになってきたということです。 米国のスミソニアン博物館、アムステルダムの 国立美術館、米国のシカゴ美術館は、一般の人々が仮想的にアクセスできるようにコレクションを公開している多くの美術館の一例です。
API を調査する
サードパーティ API の使用を調査する際の最初の手順は、そのドキュメントを確認することです。 美術館が提供している API ドキュメントを参照してください。
もう 1 つの考慮すべき点は、アクセス許可です。 使用するすべてのサードパーティ API の利用規約を読み、実行したいことが受け入れられるかどうかを確認します。 メトロポリタン美術館の利用規約ページは、始めるのに最適です。 この美術館では、Creative Commons Zero ライセンスを採用しているため、データセットに著作権はありません。 このライセンスにより、カジュアル ユーザーは API をより簡単に操作できます。
さらに、この API を使用するために API キーは必要ないため、適切な形式の URL クエリを介して GET 要求を使用することにより、コレクションの多くの要素にアクセスできます。 特定の URL にアクセスして、ブラウザー内からメトロポリタン美術館の API を使用していることになります。 この方法は、API を使用する最も簡単な方法です。 後のユニットでは、コードを使用して API を呼び出す方法を学習します。
API にクエリを実行する
オブジェクトについてクエリを実行するために使用するメトロポリタン美術館のエンドポイント (URL) は、Objects、Object (単一オブジェクトの場合)、Departments、Search です。
この API の設計は、ユーザーがコレクションを検索し、オブジェクト グループと個々のオブジェクトにドリルダウンして詳細やより多くの情報を取得することが想定されていることを示しています。 API は、段階的にビルドされています。 Department エンドポイントを含めるという選択は、データの構造とユーザーがデータを検索する方法を示している可能性があります。
たとえば、あなたが武器と甲冑に関心があるとしましょう。 Departments エンドポイントにクエリを実行して、その部門の ID を取得することができます。
https://collectionapi.metmuseum.org/public/collection/v1/departments
そのリンクをブラウザーに貼り付けると、武器甲冑部門の部門 ID が 4 であることがわかります。 これで、コレクション内の興味深い展示品を見つけるために使用できる何らかの情報が得られます。 そのためには、Search エンドポイントを使用できます。
この API は、制御された量のデータを返そうとするため、膨大なコレクションの 5,000 年にも及ぶ美術史の範囲を考えると、departmentId のみでの検索は成功しません。 代わりに、その部門内のキーワードで検索を絞り込む必要があります。
この絞り込みアクティビティでは、URL でクエリ パラメーターを使用してエンドポイントにアクセスする必要があります。 ドキュメントで確認すると、想定されている形式は、エンドポイントに ?q=keyword(s) を追加したものです。 このため、型押しされた銀製の武器および甲冑のみを検索するには、文字列 https://collectionapi.metmuseum.org/public/collection/v1/search?departmentId=4&q=embossed%20silver をブラウザーに貼り付けます。 27 の品目が返されます。
このクエリは、返されたオブジェクトを取得するための情報を提供します。 グループ内の最初のオブジェクトを調べる場合は、エンドポイント https://collectionapi.metmuseum.org/public/collection/v1/objects/626019 にアクセスします。 返されたデータによって、張り子の兜も揃っている 1800 年製の荘厳な甲冑一式が現れます。 それを身に纏った部隊を想像することしかできません。
この兜は、1988 年にメトロポリタン美術館によって収蔵され、現在、武器甲冑部門で展示されています。
まとめ
メトロポリタン美術館のよく整理されたアクセスしやすい API は、Web サイトで API をどのように使用するかを想像するのに最適な場所です。 search エンドポイントとクエリ パラメーターを使用して検索をビルドできます。 objectId のグループについて department にクエリを実行し、それをループして、関心のあるオブジェクトの一覧を作成することができます。 コレクションの基になっているデータベースに接続することなく、それを理解することさえも必要なく、コレクションを詳細に調べることができます。 これが、素晴らしい API の力です。