日本語係り受け解析

日本語文の係り受け関係を解析する機能を提供します。

リクエストURL

JSON
https://jlp.yahooapis.jp/DAService/V2/parse
※GETリクエストには対応していません。
※Client ID(アプリケーションID)をリクエストに付与する必要があります。詳細はサンプルコードをご覧ください。

リクエストパラメータ(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は、1リクエストの最大サイズを4KBに制限 しています。また、利用回数の制限については利用回数の制限についてをご参照ください。

アプリケーションの管理

目次

利用のルール

開発のヒント