初心者がCOTOHAを使ってみました～①環境構築～

#１．概要
最近私はAIに興味を持ち、Pythonでディープラーニングの技術を取得しようといろいろ記事を調べております。AIを調べる中で、画像認識や自然言語処理、音声認識等が重要な技術とわかり、これらの技術に興味を持ちました。

その中で、QiitaのトップにCOTOHAの企画が出ているの見て、自然言語処理、音声認識の技術習得の1つとしていいかな、と思い記事を書いてみることにしました。
([COTOHA APIへのリンク](https://api.ce-cotoha.com/contents/index.html))


今回は「①環境構築」について記載したいと思います。

※また、私の利用している環境は以下となっています。
OS：Windows10
プラウザ：Firefox（73.0）


#２．COTOHAの構成と実行準備

簡単にCOTOHAの特徴をまとめると、以下のようになっているようです。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/547663/0d87da38-2848-f8d3-c9ee-07f6a787767b.png)

まず自分のPCにCOTOHA APIに接続できる環境を作り、そこから文字や音声のデータを送ります。そうすると、APIから送ったデータの解析結果が返ってくるという仕組みです。


では[以下サイト](https://api.ce-cotoha.com/contents/developers/index.html)から無料登録を行います。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/547663/e2a3cc5e-f580-80ae-5f33-855687f5ca36.png)



登録が終われば、[以下サイト](https://api.ce-cotoha.com/login
)からログインできます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/547663/19eb3a42-dd48-e5cc-942d-f5cbd2a4eafc.png)


#３．APIの基本構造

COTOHA APIは以下のようにして動かすようです。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/547663/226c6ef1-771b-07b6-f1e3-6a89f3709f1a.png)

### STEP1 アクセストークンの発行

まず各APIを動かすためのアクセストークンを生成します。こちらは、各APIを動かすためのパスワードのようなもので、**1回発行すると24時間使えます。**

### STEP2 各APIの利用

STEP1で発行したアクセストークンと各APIに必要なデータを送ることで、各APIを動かすことができます。例えば、構文解析をしたい場合、アクセストークン＋解析したい文字データを構文解析APIに送ることで、構文解析の結果が返ってきます。

#４．APIでアクセストークンを取得してみよう

次に[以下ページ](https://api.ce-cotoha.com/contents/gettingStarted.html)をもとに、アクセストークン取得APIを動かしてみることにしました。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/547663/4d1d85d3-8921-2175-61a8-69b8d74aa481.png)

上記資料から、大きく以下2つの方法があることがわかります。

- CASE01　ブラウザによるAPIの利用
- CASE02　cURLによるAPIの利用(Mac, Linux等)

私のPCはWindows端末ですので、CASE01の方法を試してみます。説明文を読むとQiitaに設定の記事があるとのことで、[対象のリンクをクリック](https://qiita.com/tags/cotoha)します。

が、**記事が見当たりません。。。**

パット見た限り、説明の記事がないので「COTOHA　Firefox」で検索をかけてみて、一番上位に来たこの記事が、おそらくプラウザによるAPIの動作を書いたものと思いました。
[「初心者の私が、ブラウザで自然言語処理API(COTOHA API)を試せるようになるまで【基本ガイド】」](https://qiita.com/nach0chos557/items/28970528b7f07d3a3c2f)


上記記事に内容通り、まずはFirefoxをインストールし、その後
https://addons.mozilla.org/ja/firefox/addon/restclient/
のアドオンを追加します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/547663/f07699dd-92ec-342f-b990-e5fbd0aec3d8.png)


そしてアクセストークン取得APIを動かすためのデータを作成します。
まず、画面左上のMethodを**「POST」**にします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/547663/cd8ca29b-64a0-f30a-fa30-f157b2cbb82a.png)

次にURLの部分に「Access Token Publish URL」の内容を入力します。

![i
mage.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/547663/abb47ac6-ce4d-3087-9bc0-7bdd27721447.png)

　　　　　　　　　　　　　　　↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/547663/01c60101-e8f2-e23b-2ece-2a39519de41a.png)

次に画面上部の**「Headers」**を選択し、**「Custom Header」**をクリックします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/547663/3b2e4f3f-ff04-28a3-a394-4499089688b5.png)

表示されるポップアップに対して以下を入力し、「Okay」ボタンを押下します。
Name：「Content-Type」
Attribute Value：「application/json」

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/547663/f8c7dbfa-1e4e-237f-9267-067adc1058fb.png)

その後、以下のようにHeadersが画面に追加され、**「Content-Type: application/json」**と記載されていれば成功です。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/547663/45b9fb5e-d6a0-9e33-d1df-3a5a05b31479.png)

その後Bodyに以下コードを入力してください。
**また、コードに入力するclientIdとclientSecretはアカウントホームに表示されているClient IDとClient secretを記載してください。**
（私は記事のソースをそのままコピペして使い、エラーを発生させました…）

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/547663/aa192967-1893-648a-8b89-58a299158d75.png)

　　　　　　　　　　　　　　　↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓

	{
	"grantType":"client_credentials",
	"clientId": "ログイン後の画面に表示されるClient ID",
	"clientSecret": "ログイン後の画面に表示される Client Secret"
	}


　　　　　　　　　　　　　　　↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/547663/46a91e8a-bbec-3699-6633-12e84c5db991.png)

その後、「SEND」を押下します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/547663/8cb2de4b-ac08-8033-1d9a-b7ee52cd0dc1.png)

そして画面下側の「Response」を押下すると、COTOHA APIからの返信結果が返ってきています。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/547663/b0845240-6b3b-4f92-0e38-f10370350926.png)

この発行された「access_token」を用いて、必要なAPIを動かして行くことになります。

#５．まとめ

時間がかかりましたが、APIを動作するための準備が整いました。
次は各APIを動かしてみて、どんな結果が返ってくるのか試してみたいと思います。