You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
aruppi-api/README.md

6.3 KiB

Aruppi API (v4.0.0)

This API has everything about Japan, from anime, music, radio, images, videos ... to japanese culture

These are the services used for the Aruppi App (only available in Spanish language)

node version npm version yarn version type code maintenance now gitrepo


📖 API Documentation

Soon we will add the documentation information in a link

Link to access the Aruppi API

📚 Development Diary

Describe the purpose of the project and give clues about what the code does. For more information go to the following link Diary Reference.

🔧 Developer usage

Set up project

Before cloning the repo be sure you have installed:

  • NODE (version >= 12.17.x)

In your package manager you can use either yarn or npm, you need to have installed these versions:

  • NPM (version >= 6.14.x)
  • YARN (version >= 1.22.x)

Then:

  • Choose a folder project in your system and switch in cd [folder path]
  • Clone the repo in your folder path git clone https://github.com/aruppi/aruppi-api

Installation

In order to install the project and all dependencies, enter in the project folder and run npm install or you can do the same with yarn with yarn in the project


Start the project

npm start

or

yarn start

Build the Project

npm build

or

yarn build

Test the project

npm test
yarn test

Documentation for the V4 of the API

First of all you need to have installed yarn or npm, the required versions that we mentioned above in this README, we need to have installed too MongoDB (you can configure the port for the database in the .env file).

In order to install and migrate the data to the database, we need to have some scripts first for each collections that you want to have in the database.

Installing mongodb in Linux:

  • First we need to install MongoDB Community, in this link you have a more specific installation method - MongoDB Community Version 4.4 for Ubuntu 20.04 (Focal)
  • After these you only need a sudo systemctl status mongod to check if the service of mongo is already running, if all is good you can continue with the docs
  • Next step is migrating the data from the JSON's to the database, in this case we are having a separate folder for these scripts

Running the scripts for the poblation of the database of mongodb:

  • We need to download the mongoScripts folder, in order to run all of these scripts, we need to run first (if you have npm, it would be npm install to install all the dependencies of this folder) yarn to install the dependencies
  • After installing the dependencies of this folder, next we are building the project what is in TypeScript and we need to build to JavaScript, we do a yarn build (in npm would be npm build)
  • Next in order to migrate all the information from the JSON files, we are going to execute the following commands (if you have npm, the only difference is change the word of yarn to npm): yarn radio; yarn genre; yarn theme; yarn directory; yarn waifu;

Deprecated v1 for API

Aruppi has grown since it was launched and we need to continue improving the application along with the services to be able to give new features.

But if you need to see the code or the operation of the old version you can do it

Countdown to deprecation of v2 API

Aruppi has grown since it was launched and we need to continue improving the application along with the services to be able to give new features.

At this time version 2.6.9 will remain functional until Aruppi App users fully migrate to version 1.5.0 of the app

🤝 Contributing

  • Fork it!
  • Create your feature branch: git checkout -b my-new-feature
  • Commit your changes: git commit -am 'Add some feature'
  • Push to the branch: git push origin my-new-feature
  • Submit a pull request

👥 Credits

  • Darkangeel (System administration authority (SYSADM))
  • Jéluchu (Android Developer, designer, and others)
  • Capitanwesler (Backend developer, web developer and others)

❤️ Show your support

Please this repository if you like it or this project helped you!
Feel free to open issues or submit pull-requests to help me improving my work.


📚 Projects that use the API

Jeluchu
Aruppi

Anime y Manga
Jeluchu
Akiyama

Web and App

🤖 Author

Jéluchu

You can follow me on github · twitter


Copyright © 2020 Jéluchu.