みさくら語コンバーター APIドキュメント (古文解析版)

古文（中古和文）の解析および現代文からの古文変換に対応したAPIです。

API仕様

エンドポイントURL

https://keichankotaro.com/misakura/api/convert/

HTTPメソッド

POST

リクエストヘッダー

リクエストのヘッダーには `Content-Type` を指定する必要があります。

Content-Type: application/json;charset=UTF-8

リクエストボディ

リクエストボディは、JSON形式で送信してください。dict キーに uni-chuko を指定することで、古文用の変換処理が行われます。

自動判定・自動変換の挙動

dict に uni-chuko を指定した場合、入力された文字列の言語が自動で判定されます。

• 入力が「現代文」と判定された場合: 自動的に「現代語 → 古文」の変換（翻訳）結果が返却されます。
• 入力が「古文」と判定された場合: 中古和文辞書を用いて古典日本語を形態素解析し、古典用の語尾や助動詞ルールを適用した「古文みさくら語」の変換結果が返却されます。

{
    "data": "変換したい文章をここに入力します。",
    "dict": "uni-chuko"
}

レスポンスボディ

レスポンスは、変換後の文字列が data というキーに格納されたJSON形式で返却されます。

{
    "data": "変換結果の文字列がここに返却されます。"
}

実装例

cURLでの使用例 (現代文 → 古文)

curl -X POST \
-H "Content-Type: application/json;charset=UTF-8" \
-d '{"data": "私はとても美しい花を見ました。", "dict": "uni-chuko"}' \
https://keichankotaro.com/misakura/api/convert/

# 出力結果: {"data": "麻呂はいとうつくしき花を見侍りき。", ...}

cURLでの使用例 (古文 → 古文みさくら語)

curl -X POST \
-H "Content-Type: application/json;charset=UTF-8" \
-d '{"data": "思ひつつ寝ればや人の見えつらむ", "dict": "uni-chuko"}' \
https://keichankotaro.com/misakura/api/convert/

# 出力結果: {"data": "思ひちゅちゅ寝ればや人のぉおお見えちゅらむぅぅぅん", ...}

JavaScript (Fetch API) での使用例

const textToConvert = "思ひつつ寝ればや人の見えつらむ";

fetch('https://keichankotaro.com/misakura/api/convert/', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json;charset=UTF-8'
    },
    body: JSON.stringify({
        data: textToConvert,
        dict: "uni-chuko"
    })
})
.then(response => response.json())
.then(data => {
    console.log(data.data); // "思ひちゅちゅ寝ればや人のぉおお見えちゅらむぅぅぅん"
})
.catch(error => {
    console.error('エラーが発生しました:', error);
});