CMS Sekolahku API

If your school has a website that is powered using CMS Sekolahku (especially in Indonesia), you can get every* online public data on the website using this API!

You can get current post feed (Newest posts)

const api = require('cms_sekolahku_api');
const school = new api.BaseAPI("https://cms.sekolahku.web.id/")

school.posts.feed().then((response) => {
    console.log(response)
})

or even, post a comment!

const api = require('cms_sekolahku_api');
const school = new api.BaseAPI("https://cms.sekolahku.web.id/")

school.comments.postComment(69, "mukeenanyafiq", "[email protected]", "https://example.com", "Merdeka!").then((response) => {
    // Checks if the comment were successfully posted
    console.log(response.status)
})

Currently, this module includes:

• getting post feed;
• getting posts by category, tag, and archives;
• getting comments on a post;
• post a comment;
• gets a gallery of photos and videos, also previewing them;
• gets all student information;
• .. alumni;
• .. employees;
• .. opening speech;
• .. subscribing for the latest posts;
• .. voting in the latest polls;
• .. and a list of available downloadable files

URL Path

This module uses a specific URL path to obtain information from your school's website and then parsing it into something readable. You can use these URL paths (by continuing from the base url) instead if you want the cheapest way

• [H] means the data needs another header for the data that were sent to return "success" status

Data that will not included in the original URL path

• post_url & post_comment_count element (from PostRows)
• photo_url element (from GalleryAlbumInformation)
• url element (from GalleryVideoInformation)

Required Headers for POST Requests

• "Content-Type": "application/x-www-form-urlencoded"
• "x-requested-with": "XMLHttpRequest"

| Origin Function | URL Path | Methods | Data to send | Returns | | --------------- | -------- | ------- | ------------ | ------- | | Posts.feed() | /feed | GET | | XHR | | Posts.getPostsByCategories() | /public/post_categories/get_posts | POST | { "page_number": number, "category_slug": string } | JSON | | Posts.getPostsByTags() | /public/post_tags/get_posts | POST | { "page_number": number, "tag": string } | JSON | | Posts.getPostsByArchives() | /public/archives/get_posts | POST | { "page_number": number, "year": string, "month": string } | JSON | | Comments.getPostComments() | /public/post_comments/get_post_comments | POST | { "page_number": number, "comment_post_id": number } | JSON | | Comments.postComment() | /public/post_comments | POST | { "comment_author": author, "comment_email": email, "comment_url": url, "comment_content": content, "comment_post_id": post_id } | JSON | | Gallery.getPhotoAlbums() | /public/gallery_photos/get_albums | POST | { "page_number": number } | JSON | | Gallery.getPhotoPreview() | /public/gallery_photos/preview | POST | { "id": number } | JSON | | Gallery.getVideos() | /public/gallery_photos/get_videos | POST | { "page_number": number } | JSON | | Student.getStudents() | /public/student_directory/get_students | POST | { "academic_year_id": number, "class_group_id": number } | JSON | | Alumni.getAlumni() | /public/alumni_directory/get_alumni | POST | { "page_number": number } | JSON | | Employee.getEmployees() | /public/employee_directory/get_employee | POST | { "page_number": number } | JSON | | OpeningSpeech.getOpeningSpeech() | /public/opening_speech | GET | | HTML | | Download.getFiles() | /public/download/get_files | POST | { "slug": string, "page_number": number } | JSON | | Subscribe.subscribe() | /subscribe | POST | [H] { "subscriber": string, "csrf_token": string } | JSON | | Pollings.vote() | /vote | POST | [H] { "answer_id": number, "csrf_token": string } | JSON |

Data to send headers for [H] | Data to send | URL Path | Headers required | | ------------ | -------- | ---------------- | | { "subscriber": string, "csrf_token": string } | /subscribe | Cookie: _sessions=string | | { "answer_id": number, "csrf_token": string } | /vote | Cookie: _sessions=string |

Install

Install using npm:

npm i cms_sekolahku_api

Contribute

This module is not complete yet. There are still hopefully more information to acquire that haven't been implemented in this API.

Most of the information were completely private and couldn't be acquired, and making it public from the school's organization will help this module grows bigger. Alternative way: making an algorithm. (could be risky when the website is modified to not look the same as the CMS Sekolahku)

However, with your help, it would be a lot faster to complete this project!

You can do:

• Try help adding/changing something (example: my bad code) in this project by making a new pull request! or
• If you find any issues/suggestions regarding about this module, make a new issue!

Anything that would improve this module a bit!

Is it recommended?

Probably not for most developers. I just made this in the first place because I was bored.