IBM Language Translator のチュートリアル Step1を実行します。

初期設定

以下のページからひとまずサインインをすませます。
IBM Watson トップページ - Japan
メールの確認がsendgrid経由で届きます。
少ないとは思いますがsendgirdをネットワーク遮断している組織はそこから先へ進めないのでメールアドレスを変えてトライしてみてください。

APIsからLanguage 言語系

IBM Watson APIs サービスカタログ - Japan

Language Translator

IBM - Language Translator | IBM Watson Developer Cloud - Japan

よく分かりにくいですが、ロケーションを米国南部以外は選択できませんでした。

価格プランをLite（無料）を選んで先へ進みます。

ダッシュボード

無事に初期登録と Language Translatorの設定が終われば、ダッシュボードに一覧が表示されます。

サービス名をクリックして先へ進みます。

管理ページ

デフォルトで管理ページが表示されます。
Language Translatorの説明が並んでいます。
チュートリアルとデモへのアクセスもこのページから出来ます。

ちょっと待って！
さっそくチュートリアルへといきたいところですが、資格情報を登録しないとチュートリアルを実行する事ができないので、まずは資格情報を登録します。

資格情報の登録

左側メニューからサービス資格情報を選びます。
新規資格情報ボタンがあるので押下します。

必用に応じて名前を変更し、「インラインの構成パラメーターの追加」はひとまず空白で進めます。

無事に追加が終わるとキーの一覧に表示されます。資格情報の表示でユーザー名とパスワードを確認します。
※後ほど使いますのでファイル等に保存しときます。

チュートリアル

左側メニューから開始を選びます。
Before you begin等が並んでいますが、ちょっと下のほうにスクロールしてStep 1: Translate textへ行きます。

Step 1: Translate text

「Hello、world！」を翻訳しよう　みたいな事が書いてあります。
サンプルは英語→スペイン語なので、英語→日本語に変えています。

Language Translatorでは日本語は"ja" と指定します。
ユーザー名とパスワードは前述資格情報でメモったものを使います。

curl -X POST --user {username}:{password} --header "Content-Type: application/json" --header "Accept: application/json" --data "{\"text\":\"Hello\",\"source\":\"en\",\"target\":\"ja\"}" https://gateway.watsonplatform.net/language-translator/api/v2/translate

テスト

curlかpostman等でテストしてみましょう。

curlの使い方は以下参照
Windows > curlを使う - Qiita
postmanの使い方は後述

jsonで以下のような応答があれば成功
認証エラー等があれば、エラーがjsonで返ってきます。

{
    "translations": [
        {
            "translation": "こんにちは"
        }
    ],
    "word_count": 1,
    "character_count": 5
}

付録

POSTMANでのPOSTテスト

POSTMANはインストール済とします。

Authの入力

新規設定、Autuorizationタブにて以下を入力します。

HTTPメソッドからPOSTを選びます。
URLには　https://gateway.watsonplatform.net/language-translator/api/v2/translate
TYPEはBasic Authを選択
ユーザー名とパスワードは資格情報にて取得したものをセット

Headerの入力

Headerタブにて以下を入力します。（順不同）

Accept：application/json
Content-Type：application/json

※Authorizationは自動で登録されます。

Bodyの入力

Bodyタブで以下のように入力します。

text：Hello
source：en
target：ja

実行

Sendボタンを押します。

しばらく待つと画面下部に応答結果が表示されます。