日本語係り受け解析（UniDic品詞体系準拠・β版）

日本語文を文節に分割し、文節間の係り受け関係と、国立国語研究所のUniDic品詞体系に準拠した形態素情報を出力します。本APIは試験提供版として公開しています。係り受け解析のベースとなる形態素解析には、「日本語形態素解析（UniDic品詞体系準拠・β版）」を使用しています。

別途提供している「日本語係り受け解析（V2）」については、こちらをご参照ください。

リクエストURL

※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.unidic」としてください。
params（必須）	object
params/q（必須）	string	解析対象のテキストです。解析可能な単位は1文のみとなります。

サンプルリクエスト

{
  "id": "1234-1",
  "jsonrpc": "2.0",
  "method": "jlp.daservice.parse.unidic",
  "params": {
    "q": "青空にたくさんの気球が浮かんでいた"
  }
}

サンプルコード

実装方法については、共通の形式を採用している以下のサンプルコードが利用可能です。

• 係り受け解析

UniDic品詞体系準拠版で利用する場合は、上記サンプル内のmethodの値をjlp.daservice.parse.unidicに書き換えて実行してください。

レスポンスフィールド

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）	文節に含まれる形態素情報のリストです。 UniDicの品詞体系に準拠しています。
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": [
          ["浮かん", "うかん", "浮かぶ", "動詞", "一般-*-*", "五段-バ行", "連用形-撥音便"],
          ["で", "で", "で", "助詞", "接続助詞-*-*", "*", "*"],
          ["い", "い", "いる", "動詞", "非自立可能-*-*", "上一段-ア行", "連用形-一般"],
          ["た", "た", "た", "助動詞", "*-*-*", "助動詞-タ", "終止形-一般"]
        ]
      }
    ]
  }
}

エラー

日本語係り受け解析（UniDic品詞体系準拠・β版）は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.unidic",
  "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"
  }
}

利用制限

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

補足情報

本APIが出力する形態素情報はUniDic品詞体系に準拠していますが、MeCab-UniDicの解析結果と完全に一致するものではありません。
形態素解析では、国立国語研究所が公開する「現代書き言葉UniDic（unidic-cwj-202302）」に基づく言語情報を参照しています（The UniDic Consortium：https://clrd.ninjal.ac.jp/unidic/）。