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.

---

📝 Tabel konten

• Tentang API

• Fitur

• Endpoints

  • Overview
  • Hiragana
  • Katakana

• Cara Pakai

• Format Response

• Contoh Output JSON

• Roadmap

---

🧐 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