Kana API Documentation

Get Kana Data by Character

Endpoint: GET /api/kana/:character

Description: Retrieve Kana data for a specific character.

Parameters:

• character (string, required): The Kana character to retrieve data for.

Responses:

200 OK
{
    "character": "あ",
    "type": "hiragana",
    "romaji": "a"
}

404 Not Found
{
    "error": "No Kana data found for {character}"
}

Get Kana Data by Type

Endpoint: GET /api/:type

Description: Retrieve Kana data by type (hiragana or katakana).

Parameters:

• type (string, required): The type of Kana (hiragana or katakana).

Responses:

200 OK
[
    {
        "character": "あ",
        "romaji": "a",
        "type": "hiragana",
        "stroke_count": 3,
        "unicode": "3042",
        "ipa": "a",
        "example_words": ["あさ (asa) - morning", "あめ (ame) - rain"]
    },
    ...
]

400 Bad Request
{
    "error": "Invalid type. Must be 'hiragana' or 'katakana'."
}

Get Kana Chart by Type

Endpoint: GET /api/chart/:type

Description: Retrieve the Kana chart by type (hiragana or katakana).

Parameters:

• type (string, required): The type of Kana chart (hiragana or katakana).

Responses:

200 OK
{
  "a": ["あ", "か", "さ", "た", "な", "は", "ま", "や", "ら", "わ"],
  "i": ["い", "き", "し", "ち", "に", "ひ", "み", "り"],
  "u": ["う", "く", "す", "つ", "ぬ", "ふ", "む", "ゆ", "る"],
  "e": ["え", "け", "せ", "て", "ね", "へ", "め", "れ"],
  "o": ["お", "こ", "そ", "と", "の", "ほ", "も", "よ", "ろ", "を"]
}

400 Bad Request
{
    "error": "Invalid type. Must be 'hiragana' or 'katakana'."
}