はじめに

前回に引き続き『APIって、どんな動きをしているの？』と構築を交えながらAPIについて学習していきたいと思いたち自分自身の2番煎じ投稿です。下記参考資料を読みながら手を動かしてAPIを構築しました

参考資料

参考リンクにはAPIのHTTPリクエスト・レスポンスなどの記述の方法などの説明があり、API分からなかったコチラを読めばOKかと
どちらもハンズオンを進める中で大変理解が捗りました

APIの仕組みが分かる・使いこなせる人材になれる記事（Pythonコード付き）
HTTPとPOSTとGET
YahooAPIを利用した天気予報ハンズオン

　構成図

　ハンズオン

0：「DeepL」でアプリケーションIDを発行する

無料で登録するを押下する

今回はAPIの学習なので無料版を選択する

アカウント情報の入力

丁寧にSimulatorもあるので挙動を確認することができます
こちらでAPIでGETする際のURLが簡単に確認できます

ターミナルに直打ちでも確認することができます

tetutetu214@mbp 20211127_lang_change % curl "https://api-free.deepl.com/v2/translate?auth_key=XXXXXXXXXX&target_lang=ja&tag_handling=0"

{"translations":[{"detected_source_language":"EN","text":"このフォームを使って、DeepL APIのサンプルGETおよびPOSTリクエストを生成することができます。翻訳したいテキストを入力して、言語を選択するだけです。サンプルリクエストは、変更するたびに自動的に再生成されます。対応するAPIコールの結果を見るには、「Send」をクリックします。"}]}%          

1：上記の内容を踏まえてコードを記述していく(最後に、まとめたコードの記述あり)

今回はSimulatorで作成した英語から日本語ではなくて、日本語を英語に翻訳させるものなので、Lang = "&target_lang=en-US"としています。
こちらもSimulatorを確認すれば、自分の設定したい言語に変更すうることが可能です

# ライブラリのインポート
import json
import requests

# ターミナルに出力する文章
print("英文にしたい日本語を記述ください")
Line = input()

# エンドポイント送付内容
Deepl_Endpoint = "https://api-free.deepl.com/v2/translate?"
Key = "auth_key=XXXXXXXXXX&"
Text = "text="
Lang = "&target_lang=en-US"

url = Deepl_Endpoint + Key + Text + Line + Lang

取得できるjsonの必要な部分を取得していきます

# 取得した情報の整形
url_info = requests.get(url)
obj = json.loads(url_info.text)

# 最終的に出力する内容
print(obj["translations"][0]["text"])

先ほどSimulatorで出力された内容が下記の画像のように返されてくるので、必要部である["translations"]の1つ目[0]の内容の["text"]をターミナルに出力するように記述

json図解

まとめたコードの記述（情報を取得表示を優先しています）

# ライブラリのインポート
import json
import requests

# ターミナルに出力する文章
print("英文にしたい日本語を記述ください")
Line = input()

# エンドポイント送付内容
Deepl_Endpoint = "https://api-free.deepl.com/v2/translate?"
Key = "auth_key=XXXXXXXXXX&"
Text = "text="
Lang = "&target_lang=en-US"

url = Deepl_Endpoint + Key + Text + Line + Lang

# 取得した情報の整形
url_info = requests.get(url)
obj = json.loads(url_info.text)

# 最終的に出力する内容
print(obj["translations"][0]["text"])

ターミナルでの画面表示

tetutetu214@mbp 20211127_lang_change % python lang_change.py
英文にしたい日本語を記述ください
コーヒをおかわりしたいです
I'd like a refill on my coffee.

2：「DeepL」での確認画面

自分のアカウントの『ご利用状況』を確認すると、現在使用している文字数を確認することが可能です

さいごに

前回記事と品を変えただけ感がものすごいですが、とりあえずLet’sハンズオン！
こうして学んでいくと、次は画像認識APIから文章を読み取ってDeepL翻訳してみたりなど身の丈にあわせた学習アウトプットを粛々と続けていきたいと思います。