/Ousu-Api

A Simple osu!API Wrapper

Primary LanguageJavaMIT LicenseMIT

OusuAPI - Osu!Api

  • A Simple osu!API Wrapper

OsuAPI V2 Version

  • This version is a little outdated! I recommend that you use the version below, as it supports versions v1 and v2 of the Osu API.
    OusuAPI

Dependencias

The dependencies are inside build.gradle

Add your dependencies!

  • Gradle
repositories {
     maven { url 'https://jitpack.io' }
}

dependencies {
     compile 'com.github.Cristian-Sknz:Ousu-Api:v2.0.1.1'
}
  • Maven
<repositories>
	<repository>
	    <id>jitpack.io</id>
	    <url>https://jitpack.io</url>
	</repository>
</repositories>
}

<dependency>
    <groupId>com.github.Cristian-Sknz</groupId>
    <artifactId>Ousu-Api</artifactId>
    <version>c</version>
</dependency>
}

Simple Use

I made it pretty simple.

OusuAPI api = new OusuAPI("API_KEY");

// Requesting a player
Request<User> userRequest = api.getUser("skiincraft", Gamemode.Standard);

/* Always remember that a "Request<?>" Class
 * will always make a new request. 
 * If the request has already been made, check using:
 */
userRequest.wasRequested(); // if requested it will return "true"

//Getting information from a player.
User user = userRequest.get();

//Print the information obtained
System.out.println("Username: " + user.getUsername());
System.out.println("Ranking: #" + user.getRanking());
System.out.println("PP: " + user.getPP());

In the case of beatmaps do

[....]
// Requesting a beatmap
Request<Beatmap> beatmapRequest = api.getBeatmap(1018869); // beatmapId

// Getting information from a beatmap.
Beatmap beatmap = beatmapRequest.get();
// BeatmapSet beatmapset = api.getBeatmapSet(474376).get(); in the case of beatmapset

//Print the information obtained
System.out.println("Title: " + beatmap.getTitle());
System.out.println("Artist: #" + beatmap.getArtist());
System.out.println("Creator: " + beatmap.getCreator());
System.out.println("BMP: " + beatmap.getBPM());

This project is not complete, I intend to update whenever I can.

Thanks for reading me :D