KamusKenyah

Dokumentasi API KamusKenyah

Panduan lengkap untuk menggunakan KamusKenyah API dalam aplikasi Anda.

Navigasi
Pengenalan
KamusKenyah API menyediakan akses ke kamus bahasa Kenyah untuk aplikasi Anda.

KamusKenyah API adalah layanan RESTful yang memungkinkan developer untuk mengintegrasikan kamus bahasa Kenyah ke dalam aplikasi mereka. API ini menyediakan akses ke database kata-kata bahasa Kenyah dengan terjemahan bahasa Indonesia.

Base URL

https://api.kamuskenyah.com
Autentikasi
Cara mendapatkan dan menggunakan API key untuk akses tanpa batas.

KamusKenyah API dapat diakses tanpa autentikasi, tetapi dengan batas penggunaan 10 permintaan per hari per perangkat. Untuk akses tanpa batas, Anda perlu mendapatkan API key.

Menggunakan API Key

Tambahkan header x-api-key ke setiap permintaan:

x-api-key: YOUR_API_KEY

Cara Mendapatkan API Key

Untuk mendapatkan API key, silakan hubungi kami melalui email di api@kamuskenyah.com atau melalui Instagram @kamuskenyah.

Batas Penggunaan
Informasi tentang batas penggunaan API.

Tanpa API Key

  • 10 permintaan per hari per perangkat
  • Batasan berdasarkan IP/Device yang sama
  • Reset setiap 24 jam

Dengan API Key

  • 1,000 permintaan per hari
  • Paket premium tersedia untuk penggunaan yang lebih tinggi

Penanganan Rate Limit

Jika Anda melebihi batas penggunaan, server akan mengembalikan status kode 429 Too Many Requests. Tunggu hingga batas penggunaan Anda direset atau dapatkan API key untuk penggunaan yang lebih tinggi.

Endpoint
Daftar endpoint yang tersedia di KamusKenyah API.
GET/dictionary

Mencari kata dalam kamus

Parameter

NamaTipeWajibDeskripsi
querystringTidakKata yang ingin dicari
searchBystringTidakJenis pencarian: "word" (Indonesia), "meaning" (Kenyah), atau "both"

Contoh Kode

fetch('https://api.kamuskenyah.com/dictionary?query=rumah', {
  headers: {
    'x-api-key': 'YOUR_API_KEY' // Opsional
  }
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

Uji Endpoint

Contoh Penggunaan
Contoh penggunaan KamusKenyah API dalam berbagai skenario.

Pencarian Kata

// Contoh pencarian kata
fetch('https://api.kamuskenyah.com/dictionary?query=rumah&searchBy=word')
  .then(response => response.json())
  .then(data => {
    if (data.length > 0) {
      console.log('Terjemahan:', data[0].kenyah);
    } else {
      console.log('Kata tidak ditemukan');
    }
  });

Terjemahan Teks

// Contoh terjemahan teks
fetch('https://api.kamuskenyah.com/translate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    text: 'Selamat pagi, apa kabar?',
    source: 'id',
    target: 'kenyah'
  })
})
  .then(response => response.json())
  .then(data => {
    console.log('Teks asli:', data.original);
    console.log('Terjemahan:', data.translation);
  });

Integrasi dengan React

import { useState, useEffect } from 'react';

function KenyahDictionary() {
  const [query, setQuery] = useState('');
  const [results, setResults] = useState([]);
  const [loading, setLoading] = useState(false);

  const searchWord = async () => {
    if (!query.trim()) return;
    
    setLoading(true);
    try {
      const response = await fetch(
        `https://api.kamuskenyah.com/dictionary?query=${encodeURIComponent(query)}`
      );
      const data = await response.json();
      setResults(data);
    } catch (error) {
      console.error('Error:', error);
    } finally {
      setLoading(false);
    }
  };

  return (
    <div>
      <input
        type="text"
        value={query}
        onChange={(e) => setQuery(e.target.value)}
        placeholder="Cari kata..."
      />
      <button onClick={searchWord} disabled={loading}>
        {loading ? 'Mencari...' : 'Cari'}
      </button>
      
      {results.length > 0 ? (
        <ul>
          {results.map((item, index) => (
            <li key={index}>
              <strong>{item.indonesian}</strong>: {item.kenyah}
            </li>
          ))}
        </ul>
      ) : (
        <p>Tidak ada hasil</p>
      )}
    </div>
  );
}
Penanganan Error
Daftar kode status dan pesan error yang mungkin dikembalikan oleh API.
Kode StatusDeskripsiContoh
200 OKPermintaan berhasil
{
  "success": true,
  "data": [...]
}
400 Bad RequestParameter tidak valid
{
  "error": "Parameter tidak valid"
}
401 UnauthorizedAPI key tidak valid
{
  "error": "API key tidak valid"
}
404 Not FoundKata tidak ditemukan
{
  "error": "Kata tidak ditemukan"
}
429 Too Many RequestsBatas penggunaan terlampaui
{
  "error": "Batas penggunaan terlampaui",
  "reset": "2023-12-31T23:59:59Z"
}
500 Internal Server ErrorKesalahan server
{
  "error": "Terjadi kesalahan pada server"
}
SDK & Libraries
Library dan SDK untuk menggunakan KamusKenyah API dalam berbagai bahasa pemrograman.

Kami menyediakan SDK dan library untuk memudahkan penggunaan KamusKenyah API dalam berbagai bahasa pemrograman. SDK ini menyediakan fungsi-fungsi yang membungkus API dan menangani autentikasi, error handling, dan rate limiting.

JavaScript/TypeScript

Instalasi:

npm install kamuskenyah-api

Penggunaan:

import { KamusKenyahAPI } from 'kamuskenyah-api';

const api = new KamusKenyahAPI({
  apiKey: 'YOUR_API_KEY' // Opsional
});

// Pencarian kata
const results = await api.search('rumah');
console.log(results);

// Terjemahan
const translation = await api.translate({
  text: 'Selamat pagi',
  source: 'id',
  target: 'kenyah'
});
console.log(translation);
Python

Instalasi:

pip install kamuskenyah-api

Penggunaan:

from kamuskenyah_api import KamusKenyahAPI

api = KamusKenyahAPI(api_key='YOUR_API_KEY')  # Opsional

# Pencarian kata
results = api.search('rumah')
print(results)

# Terjemahan
translation = api.translate(
    text='Selamat pagi',
    source='id',
    target='kenyah'
)
print(translation)

Sedang Dalam Pengembangan

SDK untuk bahasa pemrograman lain (PHP, Java, Ruby, Go) sedang dalam pengembangan. Silakan hubungi kami jika Anda membutuhkan dukungan untuk bahasa pemrograman tertentu.