ksoft.js

ksoft.js

Official API Wrapper for KSoft API, written in Node.js

Getting Started

installing...

npm install ksoft.js --save

initializing...

const Ksoft = require('ksoft.js');
const ksoft = new Ksoft(yourtoken, webhookOptions); // webhook options will be reviewed below

All functions

Images Api

ksoft.images.getRandomMeme();

ksoft.images.getRandomImage(tag);

ksoft.images.getTags();

ksoft.images.searchTags(tag);

ksoft.images.getImageFromId(snowflake);

ksoft.images.getRandomWikiHow(nsfw);

ksoft.images.getRandomCutePicture();

ksoft.images.getRandomNSFW();

ksoft.images.getRandomReddit(subReddit, removeNSFW, span);

Bans Api

ksoft.bans.add({
	user: String,
	mod: String,
	user_name: String,
	user_discriminator: String,
	reason: String,
	proof: String,
	appeal_possible: Boolean,
});

ksoft.bans.getBanInfo(userID);

ksoft.bans.check(userID);

ksoft.bans.list(page, perPage);

ksoft.bans.getUpdate(epochDate);

ksoft.bans.bulkCheck(ids, {
	moreInfo: Boolean,
	bannedOnly: Boolean,
	advancedBannedOnly: Boolean,
});

ksoft.bans.guildMembersCheck(guildMemberCollection, {
	moreInfo: Boolean,
	ignoreBots: Boolean,
});

Kumo Api

ksoft.kumo.search(q, {
	fast: Boolean,
	more: Boolean,
	mapZoom: Number,
	includeMap: Boolean,
});

ksoft.kumo.getSimpleWeather(reportType, q, units, lang, icons);

ksoft.kumo.geoip(ip);

ksoft.kumo.convertCurrency(from, to, value);

Lyrics Api

ksoft.lyrics.search(q, {
	textOnly: Boolean,
	limit: Number,
});

ksoft.lyrics.getArtistById(id);

ksoft.lyrics.getAlbumById(id);

ksoft.lyrics.getTrackById(id);

Webhook feature

This just requires adding a few things when we initiate ksoft.js

const Ksoft = require('ksoft.js');
const ksoft = new Ksoft('your ksoft token', {
	useWebhooks: true,
	port: 2000, // this is the port the http server is going to run on. This can be whatever port you want I am just using 2000 as an example
	Authentication: 'your webhook authentication token',
});

ksoft.webhook.on('ready', info => {
	console.log(info); // this will return the host your http server is running on. This is what you will give to ksoft to send the info to. { "host": "yourpublicip:theportyouspecified"}
});

that was just to get everything up and running now let's see how we can actually access that data. It's really simple :)

// this is an extension of the previous example. Everything works on events so you can simply do this

ksoft.webhook.on('ban', banData => {
	console.log(banData); // there you simply get the banInfo sent from ksoft. All the event names are the same as on the ksoft documentation so if you want more info just go to https://docs.ksoft.si/api/webhooks
});

Using the BanCreator utility

// the ksoft variable I am using is the initialized Ksoft class
const ban = new ksoft.CreateBan()
	.setUserID('1234567892355822') // this is required
	.setModID('44457845784574578')
	.setUserName('blahblahblah')
	.setUserDiscriminator('1234')
	.setReason('testing123') // also required
	.setProof('proof') // this is also required
	.isAppealable(true);

ksoft.bans.add(ban).then(res => {
	console.log(res); // { success: true}
});

Special thanks to sdf for helping me troubleshoot some stuff :)