JKT48 Connect API Client

Official JavaScript client for JKT48 Connect API. Works in Node.js and browsers (including React).

Installation

npm install @jkt48/core

Quick Start

Node.js / CommonJS

const JKT48Client = require('@jkt48/core');

const client = new JKT48Client({
  apiKey: 'YOUR_API_KEY'
});

// Get all members
const members = await client.members.getMembers();
console.log(members);

ES6 Modules

import JKT48Client from '@jkt48/core';

const client = new JKT48Client({
  apiKey: 'YOUR_API_KEY'
});

React

import { useState, useEffect } from 'react';
import JKT48Client from '@jkt48/core';

function App() {
  const [members, setMembers] = useState([]);
  
  useEffect(() => {
    const client = new JKT48Client({
      apiKey: 'YOUR_API_KEY'
    });
    
    client.members.getMembers()
      .then(data => setMembers(data))
      .catch(error => console.error(error));
  }, []);

  return (
    <div>
      {members.map(member => (
        <div key={member.id}>{member.name}</div>
      ))}
    </div>
  );
}

Configuration

Basic Configuration

const client = new JKT48Client({
  apiKey: 'YOUR_API_KEY'
});

With Priority Token

const client = new JKT48Client({
  apiKey: 'YOUR_API_KEY',
  priorityToken: 'P-ABCD1234'
});

With Admin Credentials

const client = new JKT48Client({
  apiKey: 'YOUR_API_KEY',
  adminCredentials: {
    username: 'admin',
    password: 'password'
  }
});

API Reference

Members

// Get all members
await client.members.getMembers();

// Get member detail
await client.members.getMemberDetail('Shani');

// Get birthdays
await client.members.getBirthdays();

Live Streams

// Get all current live streams
await client.live.getLive();

// Get YouTube live streams
await client.live.getYoutubeLive();

// Get IDN live streams
await client.live.getIdnLive();

// Get Showroom live streams
await client.live.getShowroomLive();

// Get recent streams
await client.live.getRecent();

// Get recent stream detail
await client.live.getRecentDetail('live123');

// Get replay streams
await client.live.getReplay();

// Get chat stream
await client.live.getChatStream('username', 'slug');

// Get Showroom chat stream
await client.live.getChatStreamShowroom('roomId');

Events

// Get all events
await client.events.getEvents();

// Get theater schedule
await client.events.getTheater();

// Get theater detail
await client.events.getTheaterDetail('theater123');

// Get video call schedules
await client.events.getVideoCall('sesi1', '2024-01-01', 'Shani');

// Get today's video call schedules
await client.events.getVideoCallToday();

Media

// Get YouTube videos
await client.media.getYoutube();

// Get news articles
await client.media.getNews();

// Get news detail
await client.media.getNewsDetail('news123');

Admin (Requires Admin Credentials)

// Get all API keys
await client.admin.getKeys();

// Get API key detail
await client.admin.getKeyDetail('key123');

// Create new API key
await client.admin.createKey('owner', '[email protected]', 'premium');

// Update API key
await client.admin.updateKey('key123', true, 'premium');

// Delete API key
await client.admin.deleteKey('key123');

// Add limit to API key
await client.admin.addLimit('key123', 1000);

// Add expiry days to API key
await client.admin.addExpiry('key123', 30);

// Get admin statistics
await client.admin.getStats();

Changelog

// Get all changelogs
await client.changelog.getChangelogs();

// Get changelog detail
await client.changelog.getChangelogDetail('changelog123');

// Create new changelog
await client.changelog.createChangelog({ title: 'Update', content: 'New features' });

// Update changelog
await client.changelog.updateChangelog('changelog123', { title: 'Updated' });

// Delete changelog
await client.changelog.deleteChangelog('changelog123');

Grow A Garden

// Get stock information
await client.garden.getStock();

// Get weather information
await client.garden.getWeather();

// Get restock timer
await client.garden.getRestockTimer();

// Get all garden data
await client.garden.getAll();

Utility Methods

// Check API status
await client.check();

// Update API key dynamically
client.setApiKey('NEW_API_KEY');

// Update priority token dynamically
client.setPriorityToken('P-NEWTOKEN');

// Update admin credentials dynamically
client.setAdminCredentials({
  username: 'newadmin',
  password: 'newpassword'
});

React Hooks Example

Create a custom hook for easier usage in React:

import { useState, useEffect } from 'react';
import JKT48Client from '@jkt48/core';

const client = new JKT48Client({
  apiKey: process.env.REACT_APP_JKT48_API_KEY
});

export function useJKT48Members() {
  const [members, setMembers] = useState([]);
  const [loading, setLoading] = useState(true);
  const [error, setError] = useState(null);

  useEffect(() => {
    client.members.getMembers()
      .then(data => {
        setMembers(data);
        setLoading(false);
      })
      .catch(err => {
        setError(err.message);
        setLoading(false);
      });
  }, []);

  return { members, loading, error };
}

// Usage in component
function MembersList() {
  const { members, loading, error } = useJKT48Members();

  if (loading) return <div>Loading...</div>;
  if (error) return <div>Error: {error}</div>;

  return (
    <div>
      {members.map(member => (
        <div key={member.id}>{member.name}</div>
      ))}
    </div>
  );
}

Error Handling

try {
  const members = await client.members.getMembers();
  console.log(members);
} catch (error) {
  console.error('API Error:', error.message);
}

Priority Token Usage

Priority tokens give your requests higher priority. You can add them in three ways:

1. In client initialization (recommended):

const client = new JKT48Client({
  apiKey: 'YOUR_API_KEY',
  priorityToken: 'P-ABCD1234'
});

2. Update dynamically:

client.setPriorityToken('P-ABCD1234');

The library automatically adds the priority token to:

• Request headers as x-priority-token
• Query parameters as priority_token
• Request body as priority_token

License

MIT

Official API Documentation

https://docs.jkt48connect.com