クエリ文字列による HTTP ヘッダの代替

ブラウザ上での WebSocket API 利用など、HTTP ヘッダを指定できない環境では、クエリ文字列で実行時設定を指定できます。

HTTP ヘッダとクエリ文字列の対応は以下のとおりです。

HTTP ヘッダ名	HTTP ヘッダの値	クエリ文字列のキー	クエリ文字列の値
Authorization	Bearer <access-token>	access-token	<access-token> ( "Bearer" という文字列は含まない )
Content-Type	audio/x-flac など	content-type	audio/x-flac など
その他の `x-mimi-` で始まるヘッダ（例： x-mimi-input-language ）	nict-asr など	HTTP ヘッダ名から先頭の `x-mimi-` を除去した文字列（例：input-language）	nict-asr など

たとえば、以下のような HTTP POST リクエストは、

POST /v1/recognize/nict HTTP/2
Host: asr.mimi.fd.ai
Content-Type: audio/x-flac
x-mimi-input-language:ja
Authorization: Bearer <accessToken>
Content-Length: 106235

以下のような HTTP POST リクエストと等価です。

POST /v1/recognize/nict?access-token=<accessToken>&content-type=audio%2Fx-flac&input-language=ja HTTP/2
Host: asr.mimi.fd.ai
Content-Length: 106235