Skip to content
This repository has been archived by the owner on Apr 16, 2024. It is now read-only.

PetarMc1/Minecraft-Items-API

Repository files navigation

Minecraft-Item-API

This project has reached end of life and is no longer maintained.

Discord GitHub Tag License

What is this?

This is an API that you can run locally and get data for Minecraft items and blocks. It uses SwaggerUI so it's easy to use.

What is it made with?

How to use

1. Clone the repository. If you plan to make changes, create a fork first!

git clone https://github.com/PetarMc1/Minecraft-Items-API

2. Install all required dependencies.

npm install

3. Set a custom port.

The default port is 6060.
You can set a custom port for the API to run on. To do so, modify the port.js file.

4. Run the script.

npm start

5. Accessing API Documentation:

You can access the API documentation by navigating to a specific URL in your web browser.

  1. Open your web browser and type http://localhost:PORT/api-docs in the address bar, replacing PORT with the port number the API is running on.

6. Using the api.

Once you are in the /api-docs page you'll see a list of available endpoints along with their descriptions, request parameters, and response schemas.

You can make requests directly from Swagger UI by clicking on the endpoint you want to test, filling in any required parameters, and clicking the "Try it out" button.

Swagger will send the request to the API server and display the response, allowing you to inspect the data returned by the API.

Contributing

Check CONTRIBUTING.md

Licence

This project is licensed under the Mit License - see the LICENSE file for details.