iclub-api
v0.1.0
Published
Unofficial iClub API client for Node.js and TypeScript (SignalR + optional browser)
Maintainers
Readme
iclub-api — Node.js / TypeScript
Unofficial iClub client for Node.js 20+. Pure ESM with TypeScript declarations, derived from the provided ModernFITCLUB implementation. GPL-3.0-only. No affiliation with iClub.
Install
When published:
npm install iclub-apiFrom the source repository:
cd nodejs
npm install
npm run buildFor optional browser features (QR, reservations, registration, top-up), install Chromium:
npx playwright install chromiumJavaScript usage
import { IClub } from 'iclub-api';
const api = new IClub();
try {
await api.login(process.env.ICLUB_EMAIL, process.env.ICLUB_PASSWORD, process.env.ICLUB_GYM);
console.log(await api.getCredit());
console.log(await api.getProfile());
console.log(await api.getCalendar({ view: 'month' }));
} finally {
await api.close();
}JavaScript and TypeScript method names use camelCase; Python uses snake_case. Browser operations use the official iClub website UI and can break when the interface changes. reserveEvent() returns confirmed: false if UI submission has not been verified on the server.
Read the full Node guide, all method signatures, security and publishing guide.
