日本語係り受け解析

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

リクエスト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(array) 文節に含まれる形態素情報のリストです。
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": 3,
        "id": 0,
        "tokens": [
          ["青空", "あおぞら", "青空", "名詞", "普通名詞", "*", "*"],
          ["に", "に", "に", "助詞", "格助詞", "*", "*"]
        ]
      },
      {
        "head": 2,
        "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"
  }
}

利用制限

日本語係り受け解析では、1リクエストの最大サイズを 4KB に制限しています。また、利用回数の制限については利用回数の制限についてをご参照ください。

アプリケーションの管理

目次

利用のルール

開発のヒント