NTTコミュニケーションズのCOTOHA API for Developersで使用できるAPIを、Oracle APEXのアプリケーションより呼び出してみます。
COTOHA API for Developers（無料）の範囲で使用できるAPIは、構文解析、固有表現抽出、照応解析、キーワード抽出、類似度算出、文タイプ判定、ユーザー属性推定(β)、言い淀み除去(β)、音声認識誤り検知(β)、感情分析です。
以下のようなアプリケーションを作成します。
APIの入力については、入力項目に対応するページ・アイテムを作成します。APIの応答はJSONを整形して表示します。それぞれのAPIの入力項目は似ているため、サービスごとのページの実装にそれほど違いはありません。
最初にWeb資格証明を作成します。
ワークスペース・ユーティリティよりWeb資格証明を開きます。
作成するWeb資格証明の名前はCOTOHA API Keyとします。静的識別子としてCOTOHA_API_KEYを指定します。
COTOHA APIのリファレンスのアクセストークン取得のページには、認証方式(grantType)としてclient_credentialsを指定すると記載されているため、本来であればWeb資格証明の認証タイプとしてOAuth2クライアント資格証明フローが指定できるはずです。しかし、apex_web_service.make_rest_requestの引数p_credential_static_idにこのタイプの資格証明、引数p_token_urlにAccess Token Publish URLとして与えられている以下のURLを指定しても、APIの認証に失敗します。
https://api.ce-cotoha.com/v1/oauth/accesstokens
APEXはclientIdとclientSecretはAuthorizationヘッダーのBasic認証の値として送信しますが、COTOHA APIはJSONドキュメントとして送信されることを要求しています。その違いが認証に失敗する原因と想定されます。
そのため、認証タイプとしてHTTPヘッダーを選択し、資格証明名はHTTPヘッダー名であるAuthorizationを指定します。資格証明シークレットは、PL/SQLコード中でAccess Token Publish URLを呼び出して取得したアクセス・トークンを設定します。作成画面では、資格証明シークレットの設定は不要です。
URLに対して有効は、https://api.ce-cotoha.comを指定します。
アプリケーション作成ウィザードを起動し、空のアプリケーションを作成します。作成したアプリケーションの名前はCOTOHAとしています。
アプリケーション定義の置換に、いくつか置換文字列を定義します。
置換文字列G_CLIENT_IDの置換値としてDeveloper Client idの値、G_CLIENT_SECRETとしてDeveloper Client secretの値を設定します。今回はAPIの検証が目的であり、API自体も無料で利用できる範囲であるため、これらの値を置換文字列として設定しています。一般の開発者は、これらの値を参照できない形で保存することが推奨です。
置換文字列G_CREDENTIAL_STATIC_IDの置換値として、COTOHA_API_KEYを設定します。
ホーム・ページにアクセス・トークンを取得するボタンを作成します。
識別のボタン名はGET_ACCESS_TOKEN、ラベルはGet Access Tokenとします。動作のアクションはデフォルトのページの送信です。
アクセス・トークンを取得するプロセスを作成します。アクセス・トークンの取得は、以下のPL/SQLコードで実施します。
expires_inで指定されている秒数が経過すると取得したアクセス・トークンは無効になるため、更新する必要があります。今回のアプリケーションは、アクセス・トークンの更新までは実装していません。
COTOHA APIを呼び出すラッパーとなるファンクションを作成します。以下のコードをSQLコマンドより実行すると、ファンクションCALL_COTOHA_APIが作成されます。
それぞれのAPIを呼び出す画面を作成します。
構文解析の画面は以下のような実装になります。
APIの入力となるページ・アイテムを作成します。構文解析では、P1_SENTENCEとP1_TYPEを作成しています。APIを呼び出すボタンSUBMIT、APIの出力を表示するページ・アイテムPx_RESULTは、すべてのページにあります。
APIを呼び出すプロセスのタイプとしてAPIの呼び出しを選択します。設定のタイプにPL/SQL Procedure or Functionを選択し、プロシージャまたはファンクションとして先ほど作成したCALL_COTOHA_APIを選びます。
パラメータのファンクションの結果の値として、P2_RESULTを選択します。ページ番号は変わりますが、どのCOTOHA APIでもページ・アイテムPx_RESULTがファンクションの結果を保持します。
引数p_apiの値のタイプとして静的値を選択し、静的値として、ベースURLの部分を除いたAPIのURLを指定します。
引数p_requestの値のタイプとしてPL/SQLファンクション本体を選択し、PL/SQLファンクション本体として以下のコードを記述します。ページ・アイテムの値を属性として含んだJSON文書を作成します。
引数p_credential_static_idとして、置換文字列のG_CREDENTIAL_STATIC_IDを指定します。
引数p_requestを作成するコードやp_apiのURLは、呼び出すCOTOHA APIのサービスごとに変更して、構文解析以外のサービスを呼び出すページを作成しています。
COTOHA APIを呼び出すOracle APEXのアプリケーションは以上で完成です。
今回作成したAPEXアプリケーションのエクスポートを以下に置きました。
https://github.com/ujnak/apexapps/blob/master/exports/cotoha-api.zip
Oracle APEXのアプリケーション作成の参考になれば幸いです。
完
