必須のもの(u、d、a)と省略可能なもの(c、r)に分かれます。すてべのパラメータはHTTPボディにマルチーパート方式で格納して送信することが可能です。aの音声データは、必ず「マルチパートの最終パート」で送信する必要があります。それ以外のパラメータはURLクエリー文字列で送信することも可能ですが、HTTPヘッダのサイズ制限に抵触しないよう、すべてのパラメータをマルチパート方式で送信することを推奨します。URLのクエリー文字列とマルチパートの両方に同じパラメータが指定されている場合、マルチパートに格納された値が優先されます。AppKeyを指定します。AppKeyを使用するようにしてください。ワンタイムAppKeyについてを参照してください。dパラメータの中は、キーバリュー形式の「子パラメータ」を、半角スペース区切りで複数格納することができます。URLエンコードされている必要があります。これは、マルチパートに格納する場合でも同様です。従って、より詳細に書けば、以下の形式になります。...URLエンコードされる前の文字コードはUTF-8であること、半角スペースが”%20′′に変換されるエンコード方式であることに留意ください。「子パラメータ」の種類は以下の通りです。このうち、必須は接続エンジン名(grammarFileNames)だけになります。>このセッションで使用したい「接続エンジン名」(認識エンジン)を指定します。1回のセッションで使用可能な接続エンジン名は、1個です。使用可能な接続エンジン名の一覧は、マイページに表示されています。・プロファイルID(profileId)profileId=<URLエンコードされた値>プロファイルとは、音声認識サーバ上に存在するユーザー固有のデータファイルであり、主としてユーザーの登録単語を保存するために利用されます。プロファイルIDはそのデータファイルの識別子です。本サービスでは、ユーザー登録時に、ユーザーIDと一致したプロファイルIDが自動的に各ユーザに振り出されています。ユーザーが自分の単語登録ページで単語を登録した場合、その単語は、ユーザーIDを識別子とするプロファイル(マイ単語帳)に保存されることになります。(例)ユーザIDが「aiueo12345」の場合、「:aiueo12345」をURLエンコードした文字列を値とします。“%3A”は、半角コロンがURLエンコードされたものです。・単語登録リスト(profileWords)profileWords=<URLエンコードされた値>このセッションの認識処理で利用することを目的として、一時的な単語登録をすることができます。ひとつの単語は『表記(半角スペース)読み』という形式で登録します。複数登録する場合は、単語と単語を「|」(半角縦棒)で区切ります。値のフォーマットは以下のようになります。読み4※通常は、マイページの単語登録画面で単語登録を行う方が効率的です。プロファイルと単語登録についてを参照してください。※profileWordsで一時的な単語登録を行う場合には、profileIdを指定する必要はありません。profileWordsに沢山の単語を設定してクエリー文字列で送信すると、HTTPヘッダのサイズ制限に抵触する場合があります。それを避けるためにも、dパラメータはマルチパート方式で送信してください。音声のバイナリデータを格納します。このデータは必ずHTTPマルチパートの最終パートに格納する必要があります。音声フォーマットについてを参照して下さい。ヘッダのついた音声データ(WAVやOgg)を送信する場合は省略可能です。RAWデータ(PCM)を送信する場合には、このパラメータにフォーマット名を指定する必要があります。音声フォーマットについてを参照してください。”JSON”を指定します。省略時のデフォルト値も”JSON”になっています。「dパラメータの値」の構造は以下の通りです。value>]*dパラメータをマルチパートPOST送信する場合リクエストをマルチパートPOSTする場合は、dパートのボディに「dパラメータの値」をそのまま格納すればOKです。grammarFileNamesを-a-Generalとし、profileWordsにひとつの単語(表記がhogehogeで読みが「ほげほげてすと」)をセットする場合の、「dパラメータの値」は以下のとおりです。value>が含まれています。profileWords=hogehoge%20%E3%81%BB%E3%81%92%E3%81%BB%E3%81%92%E3%81%A6%E3%81%99%E3%81%A8dパラメータをURLクエリ文字列として送信する場合dパラメータをクエリー文字列(GET)で送る場合には、上の「dパラメータの値」全体が”d=”の右に来るひとつの値となりますので、「dパラメータの値」そのもの(全体)を再度URLエンコードする必要があります。変換されることになります。以下は、実際にクエリー送信する場合の例です。https://aaa.bbb.ccc?d=grammarFileNames%3D-a-General%20profileWords%3Dhogehoge%2520%25E3%2581%25BB%25E3%2581%2592%25E3%2581%25BB%25E3%2581%2592%25E3%2581%25A6%25E3%2581%2599%25E3%2581%25A8マルチパートPOSTのリクエストイメージ以下のHTTPリクエストのイメージは、マルチパートでPOST送信する場合の、HTTPヘッダとHTTPボディです。この例では、u、d、aの各パラメータの値を格納するために、HTTPボディが3個のパートに分かれています。*2JSONに含まれるcodeとmessage一覧を参照のこと。*2JSONに含まれるcodeとmessage一覧を参照のこと。*1認識結果情報IDは、WebSocket音声認識プロトコルの場合は、発話区間毎の認識結果情報に付与されたIDとなります。HTTP音声認識プロトコルの場合は、1セッションでアップロードされた(複数の発話区間を含む可能性のある)音声データ全体の認識結果情報に付与されたIDとなります。上のcurlコマンドを実行する場合には、ダウンロードしたサンプルプログラムを解凍してできるsampleフォルダ直下をカレントディレクトリとして実行してください。これは、指定したtest.wavがみつかるようにするためです。引数の<AppKey>には、マイページに表示されている[APPKEY]を設定してください。reserved.記載の会社名および製品名は、各社の登録商標および商標です。