README.md

January 1, 2026 · View on GitHub

Kotonogi API

📌 Ringkasan

Kotonogi API adalah API publik statis berbasis JSON yang menyediakan data huruf Jepang (Hiragana & Katakana) beserta variasinya seperti Dakuten, Handakuten, dan Yoon.

API ini ditujukan untuk:

pembelajaran bahasa Jepang,
eksperimen frontend/backend,
proyek edukasi dan non-komersial.

🧐 Tentang API

Kotonogi API menyajikan data huruf Jepang dalam struktur JSON yang konsisten dan mudah dipahami.

Cakupan data meliputi:

Huruf dasar Hiragana dan Katakana
Variasi bunyi:
- Dakuten (゛)
- Handakuten (゜)
- Yoon (ゃゅょ)
Gambar cara menulis huruf (SVG)
Animasi urutan goresan (SVG)
Kosakata contoh untuk setiap huruf (jika tersedia)

Warning

API ini ditujukan untuk edukasi dan eksperimen, bukan untuk distribusi komersial skala besar tanpa izin. Semua aset SVG menyertakan informasi hak cipta di dalam file. Silahkan gunakan secara bijak

✨ Fitur

✅ Data lengkap Hiragana & Katakana
✅ Variasi Dakuten, Handakuten, dan Yoon
✅ Gambar & animasi SVG (mudah di-embed)
✅ API statis & gratis
✅ Cocok untuk web, mobile, dan materi belajar

🔗 Endpoints

Base URL

https://kotonogi-api.vercel.app

📍 Overview Endpoints

Endpoint	Deskripsi
`GET /`	Informasi & dokumentasi singkat API
`GET /full`	Semua huruf Hiragana, Katakana, Dakuten, Handakuten, dan Yoon
`GET /hirakata`	Semua Hiragana & Katakana
`GET /dakuten`	Semua huruf Dakuten
`GET /handakuten`	Semua huruf Handakuten
`GET /yoon`	Semua huruf Yoon

🟦 Hiragana Endpoints

Endpoint	Deskripsi
`GET /hiragana`	Daftar lengkap Hiragana
`GET /hiragana/full`	Daftar lengkap Hiragana (termasuk Dakuten, Handakuten, dan Yoon)
`GET /dakuten/hiragana`	Hiragana dengan Dakuten
`GET /handakuten/hiragana`	Hiragana dengan Handakuten
`GET /yoon/hiragana`	Hiragana Yoon
`GET /hiragana/:romaji`	Detail huruf Hiragana berdasarkan romaji
`GET /dakuten/hiragana/:romaji`	Detail huruf Dakuten Hiragana berdasarkan romaji
`GET /handakuten/hiragana/:romaji`	Detail huruf Handakuten Hiragana berdasarkan romaji
`GET /yoon/hiragana/:romaji`	Detail huruf Yoon Hiragana berdasarkan romaji

🟥 Katakana Endpoints

Endpoint	Deskripsi
`GET /katakana`	Daftar lengkap Katakana
`GET /katakana/full`	Daftar lengkap Katakana (termasuk Dakuten, Handakuten, dan Yoon)
`GET /dakuten/katakana`	Katakana dengan Dakuten
`GET /handakuten/katakana`	Katakana dengan Handakuten
`GET /yoon/katakana`	Katakana Yoon
`GET /katakana/:romaji`	Detail huruf Katakana berdasarkan romaji
`GET /dakuten/katakana/:romaji`	Detail huruf Dakuten Katakana berdasarkan romaji
`GET /handakuten/katakana/:romaji`	Detail huruf Handakuten Katakana berdasarkan romaji
`GET /yoon/katakana/:romaji`	Detail huruf Yoon Katakana berdasarkan romaji

🎈 Cara Pakai

Contoh Request

curl https://kotonogi-api.vercel.app/hiragana

curl https://kotonogi-api.vercel.app/hiragana/a

curl https://kotonogi-api.vercel.app/dakuten

📦 Format Response

Semua endpoint mengembalikan data dalam format JSON.

total: INT
tentang: STRING
info: STRING
penjelasan: STRING
romaji: STRING
kana: STRING
kakikata_gambar: URL_PATH
kakikata_animasi: URL_PATH
kosakata (opsional): ARRAY
arti: STRING
catatan (opsional): STRING

📦 Contoh Output JSON

GET /full

Note

Endpoint /full disediakan untuk kebutuhan eksplorasi dan pembelajaran, bukan untuk konsumsi produksi skala besar.

{
  "hiragana": {
    "total": 23,
    "tentang": "Hiragana adalah salah satu sistem penulisan...",
    "info": "Hiragana biasanya digunakan untuk...",
    "penjelasan": "Hiragana juga memiliki variasi suara yang...",
    "hiragana_huruf": [
       {
        "romaji": "a",
        "kana": "あ",
        "kakikata_gambar": "https://kotonogi-api.vercel.app/images/hiragana/a.svg",
        "kakikata_animasi": "https://kotonogi-api.vercel.app/animation/hiragana/a.svg",
        "kosakata": [
            { "romaji": "ai", "kana": "あい", "arti": "cinta" },
            { "romaji": "asa", "kana": "あさ", "arti": "pagi" }
        ]
      }
    ]
  },
  "katakana": {
    "total": 23,
    "tentang": "Katakana adalah salah satu sistem penulisan...",
    "info": "Katakana lebih sering digunakan untuk...",
    "penjelasan": "Tanda ― (sering disebut 'chōon' atau 'long vowel mark') digunakan...",
    "katakana_huruf": [ {"romaji": "a", ...}, {...} ]
  },
  "dakuten": {
    "total": 50,
    "tentang": "Dakuten adalah tanda berupa dua garis kecil...",
    "info": "Dakuten sangat penting dalam bahasa Jepang karena...",
    "penjelasan": "Dakuten diterapkan pada lima baris konsonan dasar...",
    "hiragana_huruf": [ {"romaji": "ga", ...}, {...} ],
    "katakana_huruf": [ {"romaji": "ga", ...}, {...} ],
  },
  "handakuten": {
    "total": 10,
    "tentang": "Handakuten adalah tanda berupa lingkaran kecil yang...",
    "info": "Handakuten sangat penting dalam bahasa Jepang...",
    "penjelasan": "Handakuten hanya diterapkan pada baris h dalam...",
    "hiragana_huruf": [ {"romaji": "ga", ...}, {...} ],
    "katakana_huruf": [ {"romaji": "pa", ...}, {...} ]
  },
  "yoon": {
    "total": 72,
    "tentang": "Huruf gabungan dalam bahasa Jepang biasanya merujuk pada...",
    "info": "Huruf seperti ぢゃ, ぢゅ, ぢょ lebih sering digantikan oleh...",
    "penjelasan": "Dalam bahasa Jepang, huruf gabungan ini sering...",
    "hiragana_huruf": [ {"romaji": "ga", ...}, {...} ],
    "katakana_huruf": [ {"romaji": "gya", ...}, {...} ]
  }
}

GET /hiragana

{
  "total": 23,
  "tentang": "Hiragana adalah salah satu sistem penulisan...",
  "info": "Hiragana biasanya digunakan untuk menulis kata-kata...",
  "penjelasan": "Hiragana juga memiliki variasi suara...",
  "hiragana_huruf": [
    {
      "romaji": "a",
      "kana": "あ",
      "kakikata_gambar": "https://kotonogi-api.vercel.app/images/hiragana/a.svg",
      "kakikata_animasi": "https://kotonogi-api.vercel.app/animation/hiragana/a.svg",
      "kosakata": [
        { "romaji": "ai", "hiragana": "あい", "arti": "cinta" },
        { "romaji": "asa", "hiragana": "あさ", "arti": "pagi" }
      ]
    }
  ]
}

GET /hiragana/a

{
  "romaji": "a",
  "kana": "あ",
  "kakikata_gambar": "https://kotonogi-api.vercel.app/images/hiragana/a.svg",
  "kakikata_animasi": "https://kotonogi-api.vercel.app/animation/hiragana/a.svg",
  "kosakata": [
    { "romaji": "ai", "hiragana": "あい", "arti": "cinta" },
    { "romaji": "asa", "hiragana": "あさ", "arti": "pagi" }
  ]
}

🚀 Roadmap

🔜 Website dokumentasi interaktif
🔜 Endpoint untuk pencarian huruf berdasarkan romaji (untuk semua jenis huruf)
🔜 Penambahan kosakata beserta arti dan contoh penggunaan
🔜 Pengoptimalan performa dan caching