1.0.9 • Published 7 months ago

@jkt48/core v1.0.9

Weekly downloads
-
License
MIT
Repository
github
Last release
7 months ago

JKT48 CORE

A Node.js module for accessing JKT48 data from the v2.jkt48connect.my.id API.

Documentation: For complete details about data output and API usage, visit docs.jkt48connect.my.id

Installation

npm install @jkt48/core

Features

This package provides easy access to JKT48 data through the following features:

Members

  • Get all JKT48 members
  • Get member details by name
  • Get member birthdays

Events

  • Get JKT48 events information

Recent and Live

  • Get recent activities
  • Get recent activity details
  • Get live information
  • Get live YouTube information
  • Get live IDN information
  • Get live Showroom information
  • Get YouTube content

News

  • Get news information
  • Get news details by ID

Theater

  • Get theater information
  • Get theater details by ID

Replay

  • Get all replay theater & live

Chat Stream

  • Get all chat stram for idn live & showroom

System

  • ApiKey Validation

Usage

All functions in this package require an API key that should be passed as a parameter.

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

// Example: Get all JKT48 members
async function getMembers() {
  try {
    const apiKey = 'your-api-key-here';
    const members = await jkt48Api.members(apiKey);
    console.log(members);
  } catch (error) {
    console.error(error.message);
  }
}

getMembers();

API Keys

Free API Keys

You can use the following free API keys provided by the JKT48Connect team:

  • J-D55B
  • J-QV0Z

Custom API Keys

For custom API keys with various plans such as Premium and PremiumPlus (Premium+), please contact Valzy on WhatsApp:

API Reference

Members

Get all members

const members = await jkt48Api.members(apiKey);

Get member details by name

const memberName = 'Feni';
const memberDetail = await jkt48Api.memberDetail(memberName, apiKey);

Get birthdays

const birthdays = await jkt48Api.birthday(apiKey);

Events

Get events

const events = await jkt48Api.events(apiKey);

Recent and Live

Get recent activities

const recent = await jkt48Api.recent(apiKey);

Get recent activity details

const liveId = '123456';
const recentDetail = await jkt48Api.recentDetail(liveId, apiKey);

Get live information

const live = await jkt48Api.live(apiKey);

Get live YouTube information

const liveYoutube = await jkt48Api.liveYoutube(apiKey);

Get live IDN information

const liveIdn = await jkt48Api.liveIdn(apiKey);

Get live Showroom information

const liveShowroom = await jkt48Api.liveShowroom(apiKey);

Get YouTube content

const youtube = await jkt48Api.youtube(apiKey);

News

Get news

const news = await jkt48Api.news(apiKey);

Get news details

const newsId = '123456';
const newsDetail = await jkt48Api.newsDetail(newsId, apiKey);

Theater

Get theater information

const theater = await jkt48Api.theater(apiKey);

Get theater details

const theaterId = '123456';
const theaterDetail = await jkt48Api.theaterDetail(theaterId, apiKey);

Replay

Get replay data

const replay = await jkt48Api.replay(apiKey);

Chat Stream NEW

Get chat stream idn

const chatStream = await jkt48Api.chatStream(username, slug, apiKey);

Get chat stream Showroom

const chatStreamSR = await jkt48Api.chatStreamSR(roomId, apiKey);

ApiKey Validation

const check = await jkt48Api.check(apiKey);

Error Handling

This package throws errors with descriptive messages when:

  • API key is not provided
  • Required parameters are missing
  • The API returns an error
  • Network errors occur

Example of error handling:

try {
  const members = await jkt48Api.members(apiKey);
  console.log(members);
} catch (error) {
  console.error(`Error: ${error.message}`);
}

About the Team

This module was created by the JKT48Connect team, which consists of several specialized teams:

  • J-Force: Focuses on package and module development
  • Zenova: Focuses on website and bot development (WhatsApp/Discord/Telegram)
  • JKT48Connect: The parent team that oversees all projects

All these teams were founded by Valzyy, who created the entire ecosystem.

License

MIT

Contributing

Contributions, issues, and feature requests are welcome!

1.0.9

7 months ago

1.0.8

7 months ago

1.0.7

8 months ago

1.0.6

8 months ago

1.0.5

8 months ago

1.0.4

8 months ago

1.0.3

8 months ago

1.0.2

8 months ago

1.0.1

8 months ago

1.0.0

8 months ago