テキスト解析
日本語係り受け解析
リクエストURL
JSON
https://jlp.yahooapis.jp/DAService/V2/parse
日本語文の係り受け関係を解析する機能を提供します。
リクエストパラメータ(POST)
「RESTリクエストの構築(POST)」をご参照ください。
JSON-RPC 2.0の仕様 に準拠しています。パラメータ | 値 | 説明 |
---|---|---|
id(必須) | string,integer | JSON-RPC 2.0のid。値は任意で、指定した値がレスポンスのidにも返ります |
jsonrpc(必須) | string | 値は「2.0」としてください |
method(必須) | string | 値は「jlp.daservice.parse」としてください |
params | object | |
params/q(必須) | string | 解析対象のテキストです。解析可能な単位は1文のみとなります |
サンプルリクエスト
{ "id": "1234-1", "jsonrpc" : "2.0", "method" : "jlp.daservice.parse", "params" : { "q" : "うちの庭には二羽鶏がいます" } }
サンプルコード
日本語係り受け解析を使用したサンプルコードです。
レスポンスフィールド
JSON-RPC 2.0の仕様 に準拠しています。フィールド | 値 | 説明 |
---|---|---|
id | string,integer | リクエストのidの値が返ります |
jsonrpc | string | 固定で「"2.0"」が返ります |
result | object | 係り受け解析結果 |
result/chunks | array(object) | 文節の情報群 |
result/chunks/head | integer | 修飾する文節の番号。修飾先が存在しない場合は「-1」が返ります |
result/chunks/id | integer | 文節の番号 |
result/chunks/tokens | array(string) | 形態素情報のリスト |
result/chunks/tokens/0 | string | 形態素の表記 |
result/chunks/tokens/1 | string | 形態素の読みがな |
result/chunks/tokens/2 | string | 形態素の基本形表記 |
result/chunks/tokens/3 | string | 形態素の品詞 |
result/chunks/tokens/4 | string | 形態素の品詞細分類 |
result/chunks/tokens/5 | string | 形態素の活用型 |
result/chunks/tokens/6 | string | 形態素の活用形 |
サンプルレスポンス
以下は、q=うちの庭には二羽鶏がいますのリクエストに対するレスポンスです。
{ "id":"1234-1", "jsonrpc":"2.0", "result":{ "chunks":[ { "head":1, "id":0, "tokens":[ ["うち","うち","うち","名詞","普通名詞","*","*"], ["の","の","の","助詞","接続助詞","*","*"] ] }, { "head":3, "id":1, "tokens":[ ["庭","にわ","庭","名詞","普通名詞","*","*"], ["に","に","に","助詞","格助詞","*","*"], ["は","は","は","助詞","副助詞","*","*"] ] }, { "head":3, "id":2, "tokens":[ ["二","に","二","名詞","数詞","*","*"], ["羽","わ","羽","接尾辞","名詞性名詞助数辞","*","*"], ["鶏","にわとり","鶏","名詞","普通名詞","*","*"], ["が","が","が","助詞","格助詞","*","*"] ] }, { "head":-1, "id":3, "tokens":[ ["い","い","いる","動詞","*","母音動詞","基本連用形"], ["ます","ます","ます","接尾辞","動詞性接尾辞","動詞性接尾辞ます型","基本形"] ] } ] } }
エラー
日本語係り受け解析はYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードが返ります。
また、リクエストパラメータが本ドキュメント記載の仕様と異なる場合、ステータスコード200でJSON-RPC 2.0の仕様に準拠したレスポンスが返ることがあります。
フィールド | 値 | 説明 |
---|---|---|
id | string,integer | リクエストのidの値が返ります |
jsonrpc | string | 固定で「"2.0"」が返ります |
error | object | |
error/code | integer | JSON-RPC 2.0の仕様に準拠したエラーコード |
error/message | string | JSON-RPC 2.0の仕様に準拠したエラーメッセージ |
例1:不正なJSONの場合
リクエスト
{ "id": "1234-1", "jsonrpc" : "2.0", "method" : "jlp.daservice.parse", "params" : { "q" : "うちの庭には二羽鶏がいます" }
レスポンス
{ "id": null, "jsonrpc": "2.0", "error": { "code": -32700, "message": "Parse error" } }
例2:必須のパラメータがない場合
リクエスト
{ "id": "1234-1", "jsonrpc" : "2.0", "params" : { "q" : "うちの庭には二羽鶏がいます" } }
レスポンス
{ "id": "1234-1", "jsonrpc": "2.0", "error": { "code": -32600, "message": "Invalid request" } }
例3:存在しないmethodを指定した場合
リクエスト
{ "id": "1234-1", "method": "invalid.method.name", "jsonrpc" : "2.0", "params" : { "q" : "うちの庭には二羽鶏がいます" } }
レスポンス
{ "id": "1234-1", "jsonrpc": "2.0", "error": { "code": -32601, "message": "Method not found" } }
利用制限
日本語係り受け解析Web APIは、24時間以内で1つのアプリケーションIDにつき50000件のリクエストが上限となっています。また、1リクエストの最大サイズを4KBに制限しています。詳しくは「利用制限」をご参照ください。