Go to file
Millennium Earl f0f451690c
Merge pull request #60 from MillenniumEarl/dependabot/npm_and_yarn/cheerio-1.0.0-rc.5
Bump cheerio from 1.0.0-rc.3 to 1.0.0-rc.5
2020-12-22 12:06:39 +01:00
.github Delete npm-publish.yml 2020-11-30 10:55:35 +01:00
.vscode New functions 2020-10-01 21:13:23 +02:00
app Fix bugs in platform data assignment 2020-12-17 23:09:31 +01:00
test Update test 2020-12-17 22:44:46 +01:00
.deepsource.toml Update .deepsource.toml 2020-11-02 16:32:59 +01:00
.eslintrc.json Validated eslintrc.json 2020-11-04 15:13:23 +05:30
.gitattributes Initial commit 2020-09-26 13:37:43 +02:00
.gitignore Updated code coverage 2020-11-12 15:43:12 +01:00
.npmignore Added .npmignore 2020-11-22 14:51:39 +01:00
LICENSE Added license 2020-11-12 11:42:08 +01:00
README.md Update README.md 2020-11-28 20:44:31 +01:00
coverage.lcov Update coverage reports 2020-12-15 15:24:38 +01:00
package-lock.json Merge pull request #60 from MillenniumEarl/dependabot/npm_and_yarn/cheerio-1.0.0-rc.5 2020-12-22 12:06:39 +01:00
package.json Update version 2020-12-17 23:17:16 +01:00

README.md

DeepSource CodeFactor FOSSA Status Known Vulnerabilities codecov npm

F95API

Unofficial Node JS module for scraping F95Zone platform

These APIs have been developed to support this application and allow you to obtain data on games and mods on the platform F95zone (NSFW)

A simple usage example can be found in app/example.js

Attention: Two-factor authentication is not supported

Data scraping

Games/mods can be obtained by name or URL

// The name is case insensitive
let listOfFoundGames = await F95API.getGameData("your game name");
let listOfFoundMods = await F95API.getGameData("your mod name", true);

let specificGame = await F95API.getGameDataFromURL("the URL of your game");

While user data (after authenticating) with

let authResult = await F95API.login(username, password);

let loggedUserData = await F95API.getUserData();

Classes

Games and mods

Information about games and mods is stored in a GameInfo object with the following fields:

name: The game name
author: The game developer
url: The URL that leads to the game thread on F95Zone
overview: Description of the game
language: Main language of the game
supportedOS: List of supported OS (Windows/Linux/Mac/Android...)
censored: Are the NSFW parts censored?
engine: Game engine (Unity, Ren'Py, RPGM...)
status: Completed/Abandoned/Ongoing/Onhold
tags: List of tags
previewSrc: Source URL of the game description image
version: Version of the game
lastUpdate: Date of the last update (it's a Date object)
isMod: Is it a game or a mod?
changelog: Latest changelog available

The serialization in JSON format of this object is possible through JSON.stringify() while the deserialization must happen through the static method GameInfo.fromJSON().

User data

User data (after authentication) can be stored in a UserData object, consisting of the following fields:

username: Name of the logged in user
avatarSrc: Source URL of the user's profile picture
watchedGameThreads: List of URLs of threads followed by the user

Login results

The outcome of the authentication process is represented by the LoginResult object:

success: Was the authentication successful?
message: Possible error message (unrecognized user, wrong password...) 
         or authentication successful message

Logging

To log the behavior of the application log4js is used with a default level of "warn". This option can be changed with the loggerLevel property.

Guidelines for errors

  • If you can, return a meaningful value
  • Return null only if the function should return a complex object (including strings)
  • Return an empty array if the function should return an array
  • Return false, -1 when the function should return boolean or number
  • Throw an exception only if it is an error or if a wrong value could mess up the functioning of the library