A Node.js and Deno wrapper for getting information from the Classcharts API.
Source • Issues • NPM • Deno • Discord • Library Docs • API Docs
The ClassCharts API is a typescript wrapper around the ClassCharts API. It allows you to easily make requests to the ClassCharts API without having to worry about the underlying implementation of making requests.
For any help with the library, please join the discord where you can ask questions and get help from the community.
Contributions are welcome! There are lots of API endpoints which we simply do not have access to to implement, so if you have access to them, please consider contributing! If you have any questions, feel free to ask in the discord.
- Node.js 18 or newer
OR - Deno
npm install classcharts-api # npm
The imports in the examples are for Node.js, but can easily be substituted for Deno.
import {
ParentClient,
StudentClient,
} from "https://deno.land/x/classcharts_api/mod.ts";
Before making any requests, you must login to the client. This will get you a session ID which will be used for all requests.
import { StudentClient } from "classcharts-api";
// Date of birth MUST in the format DD/MM/YYYY
const client = new StudentClient("classchartsCode", "01/1/2000");
await client.login();
?> The parent client is not tested, as I do not have access to a parent account. If you experience any issues, please open an issue or PR.
import { ParentClient } from "classcharts-api";
const client = new ParentClient("username", "password");
await client.login();
All the following methods can be used on both the student and parent client. Each example expects the client to be already logged in.
const studentInfo = await client.getStudentInfo();
console.log(studentInfo);
/**
{
success: 1,
data: {
user: {
id: 2339528,
...
}
},
meta: {
session_id: '5vf2v7n5uk9jftrxaarrik39vk6yjm48',
...
}
}
*/
// Dates must be in format YYYY-MM-DD
const activity = await client.getActivity({
from: "2023-04-01",
to: "2023-05-10",
last_id: "12",
});
console.log(activity);
// Dates must be in format YYYY-MM-DD
const activity = await client.getFullActivity({
from: "2023-04-01",
to: "2023-05-10",
});
console.log(activity);
Gets behaviour for a given date range.
// Dates must be in format YYYY-MM-DD
const behaviour = await client.getBehaviour({
from: "2023-04-01",
to: "2023-05-10",
});
console.log(behaviour);
/**
{
"success": 1,
"data": {
"timeline": [
{
"positive": 426,
...
},
],
...
"meta": {
"start_date": "2023-04-01T00:00:00+00:00",
...
}
}
*/
Gets homeworks for a given date range.
// Dates must be in format YYYY-MM-DD
const homeworks = await client.getHomeworks({
from: "2023-04-01",
to: "2023-05-10",
displayDate: 'issue_date' // Can be 'due_date' or 'issue_date'
});
console.log(homeworks);
/**
{
success: 1,
data: [
{
lesson: '7A/Pe1',
...
},
],
meta: {
start_date: '2023-04-01T00:00:00+00:00',
...
}
}
Gets lessons for a specific date.
// Dates must be in format YYYY-MM-DD
const lessons = await client.getLessons({
date: "2023-04-01",
});
console.log(lessons);
/**
{
"success": 1,
"data": [
{
"teacher_name": "Mr J Doe",
...
}
...
],
"meta": {
"dates": [
"2023-05-04"
],
...
}
}
*/
Gets all earned badges.
const badges = await client.getBadges();
console.log(badges);
/**
{
success: 1,
data: [
{
id: 123,
name: 'Big Badge',
...
},
...
],
meta: []
}
*/
Gets all announcements.
const announcements = await client.getAnnouncements();
console.log(announcements);
/**
{
success: 1,
data: [
{
id: 321453,
title: "A big announcement",
description: "<p>School will be closing early today!</p>",
...
}
],
meta: []
}
*/
?> This method does not include meta
in the response, since I do not have
access to this endpoint to test it. If you have access to this endpoint, please
open a PR to add the meta
response. Thanks!
Gets all detentions.
const detentions = await client.getDetentions();
console.log(detentions);
?> This method does not include meta
in the response, since I do not have
access to this endpoint to test it. If you have access to this endpoint, please
open a PR to add the meta
response. Thanks!
Gets attendance.
const attendance = await client.getAttendance();
console.log(attendance);
Gets a list of all pupils the parent has access to.
const pupils = await client.getPupils();
console.log(pupils);
/**
[
{
id: 123,
name: 'John Doe',
...
},
...
]
*/
Selects a pupil to make subsequent requests for.
await client.selectPupil(123);