はじめに
今回はこちらの「この猫なに猫？」APIをPythonからたたいてみます。
開発環境
- MacBook Pro (13-inch, 2018)
- macOS Monterey 12.3.1
- Visual Studio Code 1.73.1
- Python 3.9
それでは実際にたたいてみます
仕様書
このURLに識別したい画像をPOSTすると結果がJSON形式で返ってきます。
実行するには
「この猫なに猫？」APIを利用するにあたって、ユーザー登録が必要です。
「ユーザー名」「メールアドレス」「パスワード」を入れてsingupをクリックし、届いたメールから認証すれば登録完了です。
調べたい猫の画像を用意したら実際に実行してみます！
ちなみに今回はスコティッシュフォールドの画像を準備しました。
まずはターミナルからcurlコマンドで叩いてみる
curl -u xxx:yyy -F "image=@cat.jpg" http://whatcat.ap.mextractr.net/api_query
#xxx : ユーザー名
#yyy : パスワード
image@=の後には画像ファイルの名前を記載します。
そして結果がこちら
上位5種の猫種類とその確立値が出力されました！
スコティッシュフォールドの確率値が1.0となっているので、予測通りになっています。
続いてPythonから叩いてみる
今回はRequestsのPOSTメソッドを使っていきます。
pip install requests
上記のようにpipでインストールしておきます。
what-cat.py
import requests
url = "http://whatcat.ap.mextractr.net/api_query"
file = {
'image': open('cat.jpg', "rb")
}
user_name = "xxx"
user_pass = "yyy"
response = requests.post(url, files=file, auth=(user_name,user_pass))
print(response.json())
fileに読み込みたい画像ファイルを置きます。
user_nameとuser_passにはそれぞれユーザー名とパスワードを格納します。
Basic認証を使用したデータを取得したい時は、POSTメソッドを使って上記のようにauthの引数にBasic認証の情報を設定します。
Basic認証とは？
特定のWebサイトのページなどにアクセスする際、制限をかけることができる認証方法の1つ。
アクセスしようとすると、ユーザーIDやパスワードを求められます。
最後にPOSTメソッドの引数にURL、読み込むファイル、そしてユーザー名とパスワードはauthに引き渡して実行したら完成！
curlで叩いた時と同じ結果が返ってきました!
まとめ
- PythonでAPIを叩いた
- Basic認証はページにアクセス制限をかける認証方法